DXGKDDI_GET_CHILD_CONTAINER_ID Rückruffunktion (dispmprt.h)

Fragt die Container-ID für das angegebene Ziel ab. Implementiert durch Windows Display Driver Model (WDDM) 1.2 und höher Display Miniporttreiber.

Syntax

DXGKDDI_GET_CHILD_CONTAINER_ID DxgkddiGetChildContainerId;

NTSTATUS DxgkddiGetChildContainerId(
  [in]      PVOID MiniportDeviceContext,
  [in]      ULONG ChildUid,
  [in, out] PDXGK_CHILD_CONTAINER_ID ContainerId
)
{...}

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 Microsoft DirectX-Grafikkernsystem bereitgestellt.

[in] ChildUid

Ein ULONG-Wert, der das untergeordnete Gerät eindeutig identifiziert. Der Anzeige-Miniporttreiber hat diesen Bezeichner zuvor beim Aufruf der DxgkDdiQueryChildRelations-Funktion bereitgestellt.

[in, out] ContainerId

Ein Zeiger auf eine DXGK_CHILD_CONTAINER_ID-Struktur . Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Rückgabewert

Gibt einen der folgenden Fehlercodes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Treiber hat die Struktur aktualisiert, auf die der ContainerId-Parameter verweist, mit Container-ID-Informationen, die von der Anzeigehardware abgerufen wurden.
STATUS_MONITOR_NODESCRIPTOR	Der Treiber hat die Standardcontainer-ID-Informationen akzeptiert, die in der Struktur bereitgestellt werden, auf die von ContainerId verwiesen wird. Hinweis: Wenn der Treiber diesen status Code zurückgibt, sollte er die Struktur nicht ändern.

Andernfalls gibt die Funktion einen der in Ntstatus.h definierten status Codes zurück.

Hinweise

Das Betriebssystem ruft die DxgkDdiQueryChildRelations-Funktion des Display-Miniporttreibers auf, um die untergeordneten Geräte der Grafikkarte aufzulisten. Das Betriebssystem ruft dann die DxgkDdiQueryDeviceDescriptor-Funktion des Anzeigeminiporttreibers für jedes untergeordnete Gerät auf, um die EDID (Extended Display Information Data) für das Gerät abzurufen. Weitere Informationen zu diesem Verfahren finden Sie unter Auflisten untergeordneter Geräte eines Grafikkartes.

Basierend auf den EDID-Daten des Geräts generiert das Betriebssystem eine Standardcontainer-ID für das untergeordnete Gerät. Anschließend ruft das Betriebssystem die DxgkDdiGetChildContainerId-Funktion des Anzeigeminiporttreibers auf und übergibt über den ContainerId-Parameter einen Zeiger auf eine DXGK_CHILD_CONTAINER_ID-Struktur. Das ContainerId-Element dieser Struktur enthält die Standardcontainer-ID für das untergeordnete Anzeigegerät.

Der Anzeige-Miniporttreiber kann entweder die Standardcontainer-ID akzeptieren oder das ContainerId-Element auf einen eindeutigen Bezeichner für das Gerät festlegen, bevor es vom Aufruf von DxgkDdiGetChildContainerId zurückkehrt.

Weitere Informationen zu Container-IDs finden Sie unter Container-IDs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	dispmprt.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

DXGK_CHILD_CONTAINER_ID

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

DxgkDdiQueryDeviceDescriptor