DXGKDDI_ESCAPE Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Die DxgkDdiEscape-Funktion gibt Informationen mit dem Benutzermodus-Anzeigetreiber frei.

Syntax

DXGKDDI_ESCAPE DxgkddiEscape;

NTSTATUS DxgkddiEscape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_ESCAPE pEscape
)
{...}

Parameter

[in] hAdapter

Ein Handle für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Der Anzeige-Miniporttreiber hat dieses Handle zuvor für das Microsoft DirectX-Grafikkernsubsystem im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.

[in] pEscape

Ein Zeiger auf eine DXGKARG_ESCAPE-Struktur , die Informationen zu den freigegebenen Informationen enthält.

Hinweis Damit der DxgkDdiEscape-Aufruf unter der zweiten Ebene erfolgen kann, muss das HardwareAccess-Flag innerhalb der D3DDDI_ESCAPEFLAGS-Struktur festgelegt werden, die ein Element von DXGKARG_ESCAPE ist. Wenn dieses Flag nicht festgelegt ist, schlägt der Aufruf fehl.

Rückgabewert

DxgkDdiEscape gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	DxgkDdiEscape hat Informationen erfolgreich freigegeben.
STATUS_INVALID_PARAMETER	Parameter, die an DxgkDdiEscape übergeben wurden, enthielten Fehler, die den Abschluss verhinderten.
STATUS_NO_MEMORY	DxgkDdiEscape konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war.
STATUS_PRIVILEGED_INSTRUCTION	DxgkDdiEscape hat nicht privilegierte Anweisungen erkannt (d. h. Anweisungen, die über die Berechtigungen des aktuellen CPU-Prozesses hinaus auf den Arbeitsspeicher zugreifen).
STATUS_ILLEGAL_INSTRUCTION	DxgkDdiEscape hat Anweisungen erkannt, die grafikhardware nicht unterstützen konnte.
STATUS_GRAPHICS_DRIVER_MISMATCH	Der Anzeige-Miniporttreiber ist nicht kompatibel mit dem Benutzermodus-Anzeigetreiber, der den Aufruf von DxgkDdiEscape initiiert hat.

Hinweise

Das DirectX-Grafikkernsubsystem ruft die DxgkDdiEscape-Funktion des Anzeigeminiporttreibers auf, wenn der Anzeigetreiber im Benutzermodus Informationen mit dem Display-Miniporttreiber auf eine Weise freigeben muss, die nicht durch andere Treiberkommunikation unterstützt wird.

DxgkDdiEscape sollte als ausgelagert werden.