DXGKDDI_LINK_DEVICE Rückruffunktion (dispmprt.h)
Die optionale DxgkDdiLinkDevice-Funktion fragt den Display-Miniporttreiber 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 objekt physisches Gerät (PDO), das einen Grafikkarte identifiziert.
[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, 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 oder einen entsprechenden Fehlercode zurück, wenn keine Informationen zur Konfiguration des verknüpften Adapters abgerufen werden können.
Hinweise
Die DxgkDdiLinkDevice-Funktion sollte von Treibern von Grafikkarten implementiert werden, die verknüpfte Grafikkarten unterstützen.
Wenn diese Funktion bereitgestellt wird, fragt das Betriebssystem sofort nach einem Aufruf von DxgkDdiAddDevice den Anzeige-Miniporttreiber für die Konfiguration des verknüpften Adapters ab.
Wenn das Betriebssystem nicht alle erwarteten Grafikkarten in der Struktur aufzählt, auf die LinkedDevice verweist, startet das System im VGA-Modus.
Der Treiber kann nur ein führendes Glied in der Kette der verknüpften Grafikkarten aufzählen.
Plug & Play oder Stromereignisse führen dazu, dass der führende verknüpfte Adapter nach den verbleibenden verknüpften Adaptern ein- oder gestartet wird, oder umgekehrt führen solche Ereignisse dazu, dass der führende verknüpfte Adapter vor den verbleibenden verknüpften Adaptern ausgeschaltet oder deaktiviert wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | dispmprt.h |
| IRQL | PASSIVE_LEVEL |