DXGKDDI_QUERY_CHILD_RELATIONS回呼函式 (dispmprt.h)
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 結構的陣列指標。 陣列中的元素數目大於 DxgkDdiStartDeviceNumberOfChildren 參數所傳回的值。 DxgkDdiQueryChildRelations 必須填入數位中最後一個結構,其中包含描述顯示適配卡子裝置的資訊。 陣列中的最後一個結構必須保持零。
[in] ChildRelationsSize
ChildRelations 數位列的大小總計,以位元組為單位,包括結尾的零結構。
傳回值
DxgkDdiQueryChildRelations 如果成功,則會傳回STATUS_SUCCESS;否則,它會傳回 Ntstatus.h中定義的其中一個錯誤碼。
言論
顯示配接器的所有子裝置都會上線;連接到顯示配卡的監視器和其他外部裝置不會被視為子裝置。
顯示迷你埠驅動程序必須填入DXGK_CHILD_DESCRIPTOR結構的數位,每個顯示器適配卡的子系各一個。 數位必須包含所有目前子裝置和所有潛在子裝置DXGK_CHILD_DESCRIPTOR結構。 例如,如果停駐可攜式計算機會導致新的視訊輸出變成可用,即使這些視訊輸出目前無法使用,這些視訊輸出也必須在陣列中具有描述元。
DxgkDdiQueryChildRelations 函式應設為可分頁。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
目標平臺 | 桌面 |
標頭 | dispmprt.h |
IRQL | PASSIVE_LEVEL |