DXGKCB_GETHANDLEPARENT回呼函式 (d3dkmddi.h)

DXGKCB_GETHANDLEPARENT 會從指定的配置擷取父資源。

語法

DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;

D3DKMT_HANDLE DxgkcbGethandleparent(
  [in] IN_D3DKMT_HANDLE hAllocation
)
{...}

參數

[in] hAllocation

配置的句柄。 這個句柄必須是 DirectX 圖形核心子系統 (Dxgkrnl.sys指派給設定) 的核心模式句柄。

傳回值

DXGKCB_GETHANDLEPARENT 傳回與 hAllocation 參數所指定句柄相關聯之配置之父資源的圖形子系統特定句柄。

如果 DXGKCB_GETHANDLEPARENT 傳回 NULL 句柄, Dxgkrnl.sys 無法解析父資源的句柄,原因如下:

  • 因為惡意攻擊或其他 Bug,所以從使用者模式顯示驅動程式收到無效的句柄。
  • 配置有存留期問題。

如果傳回 NULL 句柄,顯示迷你埠驅動程式應該會失敗其目前執行的 DDI 函式,並STATUS_INVALID_HANDLE。

備註

若要 讓DXGKCB_GETHANDLEPARENT 傳回資源句柄, hAllocation 中的句柄必須是與資源相關聯的配置句柄;否則, DXGKCB_GETHANDLEPARENT 會傳回 NULL。

DXGKCB_XXX 函式是由 Dxgkrnl 實作。 若要使用此回呼函式,請透過 DXGKRNL_INTERFACE呼叫 DxgkCbGetHandleParent

規格需求

需求
最低支援的用戶端 Windows Vista (WDDM 1.0)
目標平台 桌面
標頭 d3dkmddi.h (include D3dkmddi.h)
IRQL < DISPATCH_LEVEL

另請參閱

DXGKRNL_INTERFACE