DXGKCB_ENUMHANDLECHILDREN回呼函式 (d3dkmddi.h)

發行項
02/23/2024

DXGKCB_ENUMHANDLECHILDREN 列舉與指定資源相關聯的配置，一次一個配置。

語法

DXGKCB_ENUMHANDLECHILDREN DxgkcbEnumhandlechildren;

D3DKMT_HANDLE DxgkcbEnumhandlechildren(
  [in] IN_CONST_PDXGKARGCB_ENUMHANDLECHILDREN unnamedParam1
)
{...}

參數

[in] unnamedParam1

描述要擷取之子配置之父資源的父資源與索引之 DXGKARGCB_ENUMHANDLECHILDREN 結構的指標。

傳回值

DXGKCB_ENUMHANDLECHILDREN 會將 Dxgkrnl 特定句柄傳回 pData 所描述的子配置。若要擷取句柄的裝置特定數據，顯示迷你埠驅動程序必須呼叫 DXGKCB_GETHANDLEDATA 函式。

如果DXGKARGCB_ENUMHANDLECHILDREN結構的 Index 成員中提供的子配置索引值超過與父資源相關聯的配置數目，DXGKCB_ENUMHANDLECHILDREN會傳回 NULL 句柄。如果 DXGKCB_ENUMHANDLECHILDREN 意外傳回 NULL 句柄，則 DirectX 圖形核心子系統無法解析父資源的句柄，原因如下：

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

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

備註

顯示迷你埠驅動程式可以在迴圈中呼叫 DXGKCB_ENUMHANDLECHILDREN ，以列舉與資源相關聯的所有配置。

配置句柄索引是以零起始。如果顯示迷你埠驅動程式將 pData-Index> 設定為 0，DXGKCB_ENUMHANDLECHILDREN傳回第一個配置句柄;如果 Index 設定為 1，DXGKCB_ENUMHANDLECHILDREN傳回第二個配置句柄，依此類傳回。如果 Index 大於與資源相關聯的配置數目， DXGKCB_ENUMHANDLECHILDREN 會傳回 NULL。

DXGKCB_XXX 函式是由 Dxgkrnl 實作。若要使用此回呼函式，請設定DXGKARGCB_ENUMHANDLECHILDREN的適當成員，然後透過 DXGKRNL_INTERFACE呼叫 DxgkCbEnumHandleChildren。