PFND3DDDI_DECODEEXTENSIONEXECUTE回呼函式 (d3dumddi.h)

  • 發行項

DecodeExtensionExecute 函式會使用指定的 Microsoft DirectX 影片加速器 (VA) 非標準譯碼裝置來執行譯碼作業。

語法

PFND3DDDI_DECODEEXTENSIONEXECUTE Pfnd3dddiDecodeextensionexecute;

HRESULT Pfnd3dddiDecodeextensionexecute(
  HANDLE hDevice,
  const D3DDDIARG_DECODEEXTENSIONEXECUTE *unnamedParam2
)
{...}

參數

hDevice

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

unnamedParam2

pData [in， out]

描述要執行的 DirectX VA 譯碼作業之 D3DDDIARG_DECODEEXTENSIONEXECUTE 結構的指標。

傳回值

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

傳回碼 描述
S_OK DirectX VA 譯碼作業已成功執行。
E_OUTOFMEMORY DecodeExtensionExecute 無法為其配置所需的記憶體來完成。

備註

使用者模式顯示驅動程式可以實作 DecodeExtensionExecute 函式，以支援標準譯碼類型的擴充功能 (，也就是非標準譯碼 GUID) 。 這些非標準譯碼類型對於設定加密和其他增強功能很有用。

當 DirectX VA 2.0 譯碼器需要非標準延伸模組時，會呼叫 DecodeExtensionExecute。

為了與可能需要這些非標準延伸模組的 DirectX VA 1.0 譯碼器相容，每當 DirectX VA 1.0 譯碼器進行執行呼叫時，就會呼叫 DecodeExtensionExecute，其中任何大於 4 的bDXVA_Func值都會在D3DDDIARG_DECODEEXTENSIONEXECUTE結構之函式成員的最大 8 位中設定。 每當 DirectX VA 1.0 譯碼器進行組態呼叫時，也會呼叫 DecodeExtensionExecute，其中任何除了 DXVA_QUERYORREPLYFUNCFLAG_DECODER_PROBE_QUERY (0xFFFFF1) 或 DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY (0xFFFFF5) 旗標以外的任何DXVA_ConfigQueryOrReplyFunc旗標，都會在最重要的 24 位函式中設定。 如需 Function 之位設定意義的詳細資訊，請參閱 DXVA_ConfigQueryOrReplyFlag 和 DXVA_ConfigQueryorReplyFunc Variables 和 bDXVA_Func Variable 主題。

由於 DirectX VA 1.0 譯碼器在DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY之前可能會進行這類設定呼叫的相容性問題，因此這些譯碼器也可以在建立譯碼裝置之前進行這類設定呼叫。 如果在建立譯碼裝置之前進行這類組態呼叫，pData 參數所指向之D3DDDIARG_DECODEEXTENSIONEXECUTE結構的 hDecode 成員會設定為 NULL。 在此情況下，驅動程式可能需要傳回錯誤 (，例如，如果驅動程式不支援與譯碼裝置無關的情況，E_FAIL) 。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 d3dumddi.h (include D3dumddi.h)

另請參閱

D3DDDIARG_DECODEEXTENSIONEXECUTE

D3DDDI_DEVICEFUNCS