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

Weitere Informationen

DxgkDdiAddDevice

LINKED_DEVICE