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 |