DXGKDDI_LINK_DEVICE Rückruffunktion (dispmprt.h)
Die optionale DxgkDdiLinkDevice-Funktion fragt den Anzeigeminiporttreiber nach Informationen zur Konfiguration des verknüpften Adapters ab.
Syntax
DXGKDDI_LINK_DEVICE DxgkddiLinkDevice;
NTSTATUS DxgkddiLinkDevice(
[in] IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
[in] IN_CONST_PVOID MiniportDeviceContext,
[in, out] INOUT_PLINKED_DEVICE LinkedDevice
)
{...}
Parameter
[in] PhysicalDeviceObject
Ein Zeiger auf ein physisches Geräteobjekt (PDO), das einen Anzeigeadapter identifiziert.
[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, out] LinkedDevice
Ein Zeiger auf eine LINKED_DEVICE-Struktur, die Informationen zur Konfiguration der verknüpften Grafikkarte enthält.
Rückgabewert
DxgkDdiLinkDevice gibt STATUS_SUCCESS zurück oder einen geeigneten Fehlercode, wenn Informationen zur Konfiguration des verknüpften Adapters nicht abgerufen werden können.
Bemerkungen
Die DxgkDdiLinkDevice--Funktion sollte von Treibern von Grafikkarten implementiert werden, die verknüpfte Grafikkarten unterstützen.
Wenn diese Funktion bereitgestellt wird, fragt das Betriebssystem den Display-Miniporttreiber unmittelbar nach dem Aufruf an DxgkDdiAddDeviceab.
Wenn das Betriebssystem nicht alle erwarteten Grafikkarten in der Struktur aufzählt, auf die durch LinkedDeviceverwiesen wird, wird das System im VGA-Modus gestartet.
Der Treiber kann nur eine führende Verbindung in der Kette der verknüpften Grafikkarten aufzählen.
Plug and Play- oder Power-Ereignisse führen dazu, dass der führende verbundene Adapter nach den verbleibenden verbundenen Adaptern ein- oder gestartet wird, oder umgekehrt führen solche Ereignisse dazu, dass der führende verknüpfte Adapter heruntergeschaltet oder deaktiviert wird, bevor die verbleibenden verknüpften Adapter.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | dispmprt.h |
| IRQL- | PASSIVE_LEVEL |