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 無法解析父資源的句柄,原因如下:
- 由於惡意攻擊或其他錯誤,從使用者模式顯示驅動程式收到無效的句柄。
- 配置有存留期問題。
如果傳回 NULL 句柄,顯示迷你埠驅動程式應該會因為STATUS_INVALID_HANDLE而失敗其目前執行的 DDI 函式。
言論
若要讓 DXGKCB_GETHANDLEPARENT 傳回資源句柄,hAllocation 中的句柄必須是與資源相關聯的配置句柄;否則,DXGKCB_GETHANDLEPARENT 會傳回 NULL。
DXGKCB_XXX 函式是由 Dxgkrnl實作。 若要使用此回呼函式,請透過 DXGKRNL_INTERFACE呼叫 DxgkCbGetHandleParent 。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista (WDDM 1.0) |
目標平臺 | 桌面 |
標頭 | d3dkmddi.h (包括 D3dkmddi.h) |
IRQL | < DISPATCH_LEVEL |