DXGKDDI_QUERY_CHILD_RELATIONS Rückruffunktion (dispmprt.h)

Artikel
02/06/2025

Die DxgkDdiQueryChildRelations Funktion listet die untergeordneten Geräte eines Anzeigeadapters auf.

Syntax

DXGKDDI_QUERY_CHILD_RELATIONS DxgkddiQueryChildRelations;

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

Parameter

[in] MiniportDeviceContext

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers stellt dieses Handle zuvor für das DirectX-Grafik-Kernel-Subsystem bereit.

[in, out] ChildRelations

Ein Zeiger auf ein Array von DXGK_CHILD_DESCRIPTOR Strukturen, die vom Aufrufer zugewiesen und nulliert werden. Die Anzahl der Elemente im Array ist ein Wert größer als der von DxgkDdiStartDevice im NumberOfChildren-Parameter zurückgegebene Wert. DxgkDdiQueryChildRelations- muss die letzte Struktur im Array mit Informationen ausfüllen, die die untergeordneten Geräte des Anzeigeadapters beschreiben. Die letzte Struktur im Array muss null bleiben.

[in] ChildRelationsSize

Die Gesamtgröße der ChildRelations- Arrays, einschließlich der nullierten Struktur am Ende.

Rückgabewert

DxgkDdiQueryChildRelations- gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist; andernfalls wird eine der in Ntstatus.hdefinierten Fehlercodes zurückgegeben.

Bemerkungen

Alle untergeordneten Geräte des Displayadapters sind integriert; Monitore und andere externe Geräte, die mit dem Displayadapter verbunden sind, gelten nicht als untergeordnete Geräte.

Der Miniporttreiber für die Anzeige muss ein Array von DXGK_CHILD_DESCRIPTOR Strukturen ausfüllen, eines für jedes untergeordnete Element des Displayadapters. Das Array muss DXGK_CHILD_DESCRIPTOR Strukturen für alle aktuellen untergeordneten Geräte und alle potenziellen untergeordneten Geräte enthalten. Wenn das Andocken eines tragbaren Computers beispielsweise dazu führt, dass neue Videoausgabeen verfügbar werden, müssen diese Videoausgabe über Deskriptoren im Array verfügen, auch wenn sie derzeit nicht verfügbar sind.

Die DxgkDdiQueryChildRelations- Funktion sollte seitenfähig gemacht werden.