diff --git a/multimedia/av_codec/codec_base/libnative_media_codecbase.ndk.json b/multimedia/av_codec/codec_base/libnative_media_codecbase.ndk.json
index 9869993692c467448e3342d62d96b9c414995a93..d6c1465c0320488a6eee92ea1de53bfd168dcc92 100644
--- a/multimedia/av_codec/codec_base/libnative_media_codecbase.ndk.json
+++ b/multimedia/av_codec/codec_base/libnative_media_codecbase.ndk.json
@@ -455,6 +455,10 @@
         "first_introduced": "20",
         "name": "OH_MD_KEY_ENABLE_SYNC_MODE"
     },
+    {
+        "first_introduced": "20",
+        "name": "OH_MD_KEY_VIDEO_DECODER_BLANK_FRAME_ON_SHUTDOWN"
+    },
     {
         "first_introduced": "10",
         "name": "OH_AVCodec_GetCapability"
diff --git a/multimedia/av_codec/native_avcodec_base.h b/multimedia/av_codec/native_avcodec_base.h
index acd89fba1dd8e71112ee3ef7e1b31e2a702a72a2..0bd50ec5b8d25d9d6b405ca18c36d415a8d73685 100644
--- a/multimedia/av_codec/native_avcodec_base.h
+++ b/multimedia/av_codec/native_avcodec_base.h
@@ -1139,6 +1139,20 @@ extern const char *OH_MD_KEY_VIDEO_ENCODER_ENABLE_PTS_BASED_RATECONTROL;
  */
 extern const char *OH_MD_KEY_ENABLE_SYNC_MODE;
 
+/**
+ * @brief Key for specifying whether to output a blank frame during video decoder shutdown,
+ * value type is int32_t (0 or 1): 1 is enabled, 0 otherwise.
+ *
+ * This is an optional key, only used when configuring a video decoder in surface mode.\n
+ * By default, this feature is disabled (0).\n
+ * When enabled, the video decoder will output a blank frame (typically black)
+ * when stop or release to ensure a smooth transition to no-signal state on display devices.\n
+ * This prevents display retention or flickering caused by abrupt termination.\n
+ *
+ * @since 20
+ */
+extern const char *OH_MD_KEY_VIDEO_DECODER_BLANK_FRAME_ON_SHUTDOWN;
+
 /**
  * @brief Media type.
  *