DXGKDDI_ESCAPE funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione DxgkDdiEscape condivide informazioni con il driver di visualizzazione in modalità utente.

Sintassi

DXGKDDI_ESCAPE DxgkddiEscape;

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

Parametri

[in] hAdapter

Handle di un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport di visualizzazione precedentemente fornito questo handle al sottosistema kernel della grafica Microsoft DirectX nel MiniportDeviceContext parametro di output della funzione DxgkDdiAddDevice.

[in] pEscape

Puntatore a una struttura DXGKARG_ESCAPE che contiene informazioni sulle informazioni condivise.

Nota Affinché il DxgkDdiEscape chiamata venga effettuata al di sotto del secondo livello, il flag HardwareAccess deve essere impostato all'interno della struttura D3DDDI_ESCAPEFLAGS membro di DXGKARG_ESCAPE. Se questo flag non è impostato, la chiamata avrà esito negativo.

Valore restituito

DxgkDdiEscape restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	DxgkDdiEscape ha condiviso correttamente le informazioni.
STATUS_INVALID_PARAMETER	I parametri passati a DxgkDdiEscape contengono errori che impedivano il completamento.
STATUS_NO_MEMORY	DxgkDdiEscape non è riuscito ad allocare memoria necessaria per il completamento.
STATUS_PRIVILEGED_INSTRUCTION	DxgkDdiEscape ha rilevato istruzioni non privilegiate, ovvero istruzioni che accedono alla memoria oltre il privilegio del processo di elaborazione centrale corrente [CPU].
STATUS_ILLEGAL_INSTRUCTION	DxgkDdiEscape ha rilevato istruzioni che l'hardware grafico non è stato in grado di supportare.
STATUS_GRAPHICS_DRIVER_MISMATCH	Il driver miniport di visualizzazione non è compatibile con il driver di visualizzazione in modalità utente che ha avviato la chiamata a DxgkDdiEscape.

Osservazioni

Il sottosistema kernel della grafica DirectX chiama il driver miniport di visualizzazione funzione DxgkDdiEscape ogni volta che il driver di visualizzazione in modalità utente deve condividere informazioni con il driver miniport di visualizzazione in modo che non sia supportato tramite altre comunicazioni driver.

DxgkDdiEscape deve essere reso pageable.