PFND3D11_1DDI_CREATEVIDEODECODER回呼函式 (d3d10umddi.h)

發行項
02/22/2024

建立視訊譯碼器物件。

語法

PFND3D11_1DDI_CREATEVIDEODECODER Pfnd3d111DdiCreatevideodecoder;

HRESULT Pfnd3d111DdiCreatevideodecoder(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11_1DDIARG_CREATEVIDEODECODER *unnamedParam2,
  D3D11_1DDI_HDECODE unnamedParam3,
  D3D11_1DDI_HRTDECODE unnamedParam4
)
{...}

參數

unnamedParam1

hDevice [in]

顯示裝置的句柄 (圖形內容) 。

unnamedParam2

pCreateData [in]

D3D11_1DDIARG_CREATEVIDEODECODER 結構的指標。這個結構會指定要建立之視訊譯碼器對象的屬性。

unnamedParam3

hDecode [in]

視訊譯碼器對象的驅動程式私用數據的句柄。

unnamedParam4

hRTDecode [in]

驅動程式在回呼運行時間時應該使用的視訊譯碼器物件的句柄。

傳回值

CreateVideoDecoder 會傳回下列其中一個值：

傳回碼	描述
S_OK	已成功建立視訊譯碼器物件。
D3DDDIERR_DEVICEREMOVED	已移除圖形配接器。
E_OUTOFMEMORY	記憶體無法完成作業。

備註

Microsoft Direct3D 運行時間會在呼叫驅動程式的 CalcPrivateVideoDecoderSize 之後呼叫 CreateVideoDecoder，以位元組為單位來判斷驅動程式對視訊譯碼器物件所需的私用數據大小。運行時間會為驅動程式配置此私人數據的記憶體。驅動程式會使用此記憶體來儲存與視訊譯碼器對象相關的私人數據。

當運行時間呼叫 CreateVideoDecoder 時，它會將句柄傳遞至 hDecoder 參數中的私人數據記憶體。這個句柄實際上是記憶體的指標。

驅動程式必須追蹤用來建立密碼編譯會話之顯示裝置的句柄。如果這些呼叫中指定的顯示裝置與用來建立視訊譯碼器的顯示裝置不同，驅動程式應該會失敗使用此建立密碼編譯會話的所有後續呼叫，例如 VideoDecoderBeginFrame。