共用方式為


ID3D11VideoContext3::D ecoderBeginFrame1 方法 (d3d11_4.h)

啟動譯碼作業來譯碼視訊畫面。

語法

HRESULT DecoderBeginFrame1(
  ID3D11VideoDecoder           *pDecoder,
  ID3D11VideoDecoderOutputView *pView,
  UINT                         ContentKeySize,
  const void                   *pContentKey,
  UINT                         NumComponentHistograms,
  const UINT                   *pHistogramOffsets,
  ID3D11Buffer                 * const *ppHistogramBuffers
);

參數

pDecoder

ID3D11VideoDecoder 介面的指標。 若要取得此指標,請呼叫 ID3D11VideoDevice::CreateVideoDecoder

pView

ID3D11VideoDecoderOutputView 介面的指標。 此介面描述將接收譯碼框架的資源。 若要取得此指標,請呼叫 ID3D11VideoDevice::CreateVideoDecoderOutputView

ContentKeySize

pContentKey 中指定的內容索引鍵大小。 如果 pContentKey 為 NULL,請將 ContentKeySize 設定為零。

pContentKey

用來加密框架數據之內容金鑰的選擇性指標。 如果未使用內容金鑰,請將此參數設定為 NULL。 如果呼叫端提供內容密鑰,則呼叫端必須使用會話密鑰來加密內容密鑰。

NumComponentHistograms

要記錄直方圖的元件數目。 使用 D3D11_FEATURE_VIDEO_DECODE_HISTOGRAM 來檢查支援。 當未錄製直方圖或不支援此功能時,請使用零。 指定的元件少於 格式,表示這些元件未啟用直方圖錄製。 元件數目上限定義為 D3D11_4_VIDEO_DECODER_MAX_HISTOGRAM_COMPONENTS

pHistogramOffsets

ppHistogramBuffers 平行陣列中起始緩衝區位移位置的陣列。 使用 D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT 來編製陣列的索引。 如果未要求元件,請指定零的位移。 位移必須對齊 256 位元組。

ppHistogramBuffers

要寫入元件直方圖之硬體的目標緩衝區陣列。 使用 D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT 來編製陣列的索引。 停用或不支援元件直方圖時,請將此參數設定為 nullptr

傳回值

如果成功 則傳回S_OK。

備註

在配置影片譯碼直方圖的資源時,允許下列 D3D11_RESOURCE_MISC 旗標。

  • D3D11_RESOURCE_MISC_SHARED
  • D3D11_RESOURCE_MISC_DRAWINDIRECT_ARGS
  • D3D11_RESOURCE_MISC_BUFFER_ALLOW_RAW_VIEWS
  • D3D11_RESOURCE_MISC_BUFFER_STRUCTURED
  • D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX
  • D3D11_RESOURCE_MISC_SHARED_NTHANDLE
  • D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE
  • D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE_DRIVER

不允許所有其他D3D11_RESOURCE_MISC旗標。

規格需求

需求
最低支援的用戶端 Windows 10 組建 20348
最低支援的伺服器 Windows 10 組建 20348
標頭 d3d11_4.h