DXGKDDI_GET_CHILD_CONTAINER_ID Rückruffunktion (dispmprt.h)
Fragt die Container-ID für das angegebene Ziel ab. Implementiert von Windows Display Driver Model (WDDM) 1.2 und höher Anzeigeminiporttreibern.
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 zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers stellt dieses Handle zuvor für das Microsoft DirectX-Grafik-Kernel-Subsystem bereit.
[in] ChildUid
Ein ULONG-Wert, der das untergeordnete Gerät eindeutig identifiziert. Der Anzeigeminiporttreiber hat diesen Bezeichner zuvor bereitgestellt, als die DxgkDdiQueryChildRelations--Funktion aufgerufen wurde.
[in, out] ContainerId
Ein Zeiger auf eine DXGK_CHILD_CONTAINER_ID Struktur. Weitere Informationen finden Sie im Abschnitt "Hinweise".
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 standardmäßigen Container-ID-Informationen in der Struktur akzeptiert, auf die von ContainerId verwiesen wird. Hinweis: Wenn der Treiber diesen Statuscode zurückgibt, sollte die Struktur nicht geändert werden. |
Andernfalls gibt die Funktion einen der statuscodes zurück, die in Ntstatus.h definiert sind.
Bemerkungen
Das Betriebssystem ruft die DxgkDdiQueryChildRelations Funktion des Anzeigeminiporttreibers auf, um die untergeordneten Geräte des Displayadapters auflisten zu können. Das Betriebssystem ruft dann die DxgkDdiQueryDeviceDescriptor- Funktion für jedes untergeordnete Gerät auf, um die Extended Display Information Data (EDID) für das Gerät abzurufen. Weitere Informationen zu diesem Verfahren finden Sie unter Aufzählen untergeordneter Geräte eines Anzeigeadapters.
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 einen Zeiger über den parameter ContainerId an eine DXGK_CHILD_CONTAINER_ID Struktur. Das ContainerId Mitglied dieser Struktur enthält die Standardcontainer-ID für das untergeordnete Anzeigegerät.
Der Miniporttreiber der Anzeige kann entweder die Standardcontainer-ID akzeptieren oder den ContainerId Member auf einen eindeutigen Bezeichner für das Gerät festlegen, bevor er vom Aufruf an DxgkDdiGetChildContainerIdzurückgegeben wird.
Weitere Informationen zu Container-IDs finden Sie unter Container-IDs.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | dispmprt.h |
| IRQL- | PASSIVE_LEVEL |