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 |