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) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | dispmprt.h |
| IRQL | PASSIVE_LEVEL |