閱讀英文

共用方式為


DXGKCB_ENUMHANDLECHILDREN回呼函式 (d3dkmddi.h)

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

語法

DXGKCB_ENUMHANDLECHILDREN DxgkcbEnumhandlechildren;

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

參數

[in] unnamedParam1

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

傳回值

DXGKCB_ENUMHANDLECHILDREN 會傳回 Dxgkrnl-specific handle to the child allocation that pData 所描述。 若要擷取句柄的裝置特定 數據,顯示迷你埠驅動程序必須呼叫 DXGKCB_GETHANDLEDATA 函式。

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

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

如果非預期傳回 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

要求

要求 價值
最低支援的用戶端 Windows Vista (WDDM 1.0)
目標平臺 桌面
標頭 d3dkmddi.h (包括 D3dkmddi.h)
IRQL PASSIVE_LEVEL

另請參閱

DXGKARGCB_ENUMHANDLECHILDREN

DXGKCB_GETHANDLEDATA

DXGKRNL_INTERFACE