DXGKDDI_ESCAPE Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die DxgkDdiEscape--Funktion teilt Informationen mit dem Anzeigetreiber für den Benutzermodus.

Syntax

DXGKDDI_ESCAPE DxgkddiEscape;

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

Parameter

[in] hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber, der zuvor dieses Handle für das Microsoft DirectX-Grafikkernsubsystem im MiniportDeviceContext Ausgabeparameter des DxgkDdiAddDevice--Funktion bereitgestellt hat.

[in] pEscape

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

Hinweis Damit das DxgkDdiEscape- Aufruf unter der zweiten Ebene erfolgen kann, muss das HardwareAccess--Flag innerhalb der D3DDDI_ESCAPEFLAGS Struktur festgelegt werden, die ein Element von DXGKARG_ESCAPEist. 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 erfolgreich Informationen freigegeben.
STATUS_INVALID_PARAMETER	Parameter, die an DxgkDdiEscape übergeben wurden, enthielt Fehler, die das Abschließen 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. a. Anweisungen, die über die Berechtigungen des aktuellen zentralen Verarbeitungsgeräts [CPU]-Prozesses hinausgehen).
STATUS_ILLEGAL_INSTRUCTION	DxgkDdiEscape hat Anweisungen erkannt, die Grafikhardware nicht unterstützen konnte.
STATUS_GRAPHICS_DRIVER_MISMATCH	Der Anzeigeminiporttreiber ist nicht mit dem Benutzermodusanzeigetreiber kompatibel, der den Aufruf von DxgkDdiEscape initiiert hat.

Bemerkungen

Das DirectX-Grafik-Kernelsubsystem ruft die DxgkDdiEscape--Funktion des Anzeigetreibers für den Display-Miniport-Treiber auf, wenn der Anzeige-Miniporttreiber Informationen auf eine Weise freigeben muss, die nicht durch andere Treiberkommunikation unterstützt wird.

DxgkDdiEscape- sollte seitenfähig gemacht werden.