DXGKDDI_QUERY_CHILD_RELATIONS Rückruffunktion (dispmprt.h)

Die DxgkDdiQueryChildRelations-Funktion listet die untergeordneten Geräte eines Grafikkartes 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 für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem bereitgestellt.

[in, out] ChildRelations

Ein Zeiger auf ein Array von DXGK_CHILD_DESCRIPTOR Strukturen, die vom Aufrufer zugeordnet und null sind. Die Anzahl der Elemente im Array ist um eins größer als der von DxgkDdiStartDevice im Parameter NumberOfChildren zurückgegebene Wert. DxgkDdiQueryChildRelations muss alle Bis auf die letzte Struktur im Array mit Informationen füllen, die die untergeordneten Geräte der Grafikkarte beschreiben. Die letzte Struktur im Array muss null bleiben.

[in] ChildRelationsSize

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

Rückgabewert

DxgkDdiQueryChildRelations gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

Alle untergeordneten Geräte der Grafikkarte sind an Bord; Monitore und andere externe Geräte, die eine Verbindung mit der Grafikkarte herstellen, gelten nicht als untergeordnete Geräte.

Der Display-Miniporttreiber muss ein Array von DXGK_CHILD_DESCRIPTOR Strukturen ausfüllen, eine für jedes der untergeordneten Elemente der Grafikkarte. Das Array muss DXGK_CHILD_DESCRIPTOR Strukturen für alle aktuellen untergeordneten Geräte und alle potenziellen untergeordneten Geräte enthalten. Wenn beispielsweise das Andocken eines tragbaren Computers dazu führt, dass neue Videoausgaben verfügbar werden, müssen diese Videoausgaben Deskriptoren im Array enthalten, auch wenn sie derzeit nicht verfügbar sind.

Die DxgkDdiQueryChildRelations-Funktion sollte ausgelagert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	dispmprt.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

DXGK_CHILD_DESCRIPTOR

DXGK_CHILD_STATUS

DxgkDdiQueryChildStatus

DxgkDdiQueryDeviceDescriptor