DXGKDDI_QUERY_CHILD_RELATIONS回呼函式 (dispmprt.h)

發行項
05/23/2024

DxgkDdiQueryChildRelations 函式會列舉顯示適配卡的子裝置。

語法

DXGKDDI_QUERY_CHILD_RELATIONS DxgkddiQueryChildRelations;

NTSTATUS DxgkddiQueryChildRelations(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] PDXGK_CHILD_DESCRIPTOR ChildRelations,
  [in]      ULONG ChildRelationsSize
)
{...}

參數

[in] MiniportDeviceContext

與顯示配接器相關聯的內容區塊句柄。顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式先前已將此句柄提供給 DirectX 圖形核心子系統。

[in, out] ChildRelations

呼叫端所配置和零之 DXGK_CHILD_DESCRIPTOR 結構的陣列指標。陣列中的元素數目大於 NumberOfChildren 參數中 DxgkDdiStartDevice 所傳回的值。 DxgkDdiQueryChildRelations 必須填入陣列中最後一個結構，其中包含描述顯示適配卡子裝置的資訊。陣列中的最後一個結構必須保持零。

[in] ChildRelationsSize

ChildRelations 陣列的大小總計，以位元組為單位，包括結尾的零結構。

傳回值

DxgkDdiQueryChildRelations 如果成功，則會傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。

備註

顯示配接器的所有子裝置都會上線;監視器和其他連接到顯示適配卡的外部裝置不會被視為子裝置。

顯示迷你埠驅動程序必須填入DXGK_CHILD_DESCRIPTOR結構的陣列，每個顯示適配卡的子系各一個。數位必須包含所有目前子裝置和所有潛在子裝置的DXGK_CHILD_DESCRIPTOR結構。例如，如果停駐可攜式計算機會導致新的視訊輸出變成可用，即使這些輸出目前無法使用，這些視訊輸出也必須在數位中具有描述元。

DxgkDdiQueryChildRelations 函式應該可分頁。