DXGKDDI_ESCAPE funzione di callback (d3dkmddi.h)

Articolo
05/26/2023

La funzione DxgkDdiEscape condivide le 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 a un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport visualizzato in precedenza ha fornito questo handle al sottosistema kernel della grafica Microsoft DirectX nel parametro di output MiniportDeviceContext della funzione DxgkDdiAddDevice .

[in] pEscape

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

Nota Affinché la chiamata DxgkDdiEscape venga eseguita sotto il 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 impediscono il completamento.
STATUS_NO_MEMORY	DxgkDdiEscape non è stato in grado di 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 è riuscito a supportare.
STATUS_GRAPHICS_DRIVER_MISMATCH	Il driver miniport visualizzato non è compatibile con il driver di visualizzazione in modalità utente che ha avviato la chiamata a DxgkDdiEscape.

Commenti

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

DxgkDdiEscape deve essere reso paginabile.