DXGKDDI_ESCAPE fonction de rappel (d3dkmddi.h)

Article
02/23/2024

La fonction DxgkDdiEscape partage des informations avec le pilote d’affichage en mode utilisateur.

Syntaxe

DXGKDDI_ESCAPE DxgkddiEscape;

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

Paramètres

[in] hAdapter

Handle d’un bloc de contexte associé à une carte d’affichage. Le pilote miniport d’affichage a précédemment fourni cette poignée au sous-système du noyau graphique Microsoft DirectX dans le paramètre de sortie MiniportDeviceContext de la fonction DxgkDdiAddDevice .

[in] pEscape

Pointeur vers une structure de DXGKARG_ESCAPE qui contient des informations sur les informations partagées.

Note Pour que l’appel DxgkDdiEscape soit effectué sous le deuxième niveau, l’indicateur HardwareAccess doit être défini dans la structure D3DDDI_ESCAPEFLAGS membre de DXGKARG_ESCAPE. Si cet indicateur n’est pas défini, l’appel échoue.

Valeur retournée

DxgkDdiEscape retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	DxgkDdiEscape a correctement partagé des informations.
STATUS_INVALID_PARAMETER	Les paramètres passés à DxgkDdiEscape contenaient des erreurs qui l’empêchaient de se terminer.
STATUS_NO_MEMORY	DxgkDdiEscape n’a pas pu allouer la mémoire nécessaire à sa fin.
STATUS_PRIVILEGED_INSTRUCTION	DxgkDdiEscape a détecté des instructions non privilégiées (c’est-à-dire des instructions qui accèdent à la mémoire au-delà du privilège du processus actuel de l’unité de traitement centrale [UC] ).
STATUS_ILLEGAL_INSTRUCTION	DxgkDdiEscape a détecté des instructions que le matériel graphique ne pouvait pas prendre en charge.
STATUS_GRAPHICS_DRIVER_MISMATCH	Le pilote miniport d’affichage n’est pas compatible avec le pilote d’affichage en mode utilisateur qui a lancé l’appel à DxgkDdiEscape.

Remarques

Le sous-système du noyau graphique DirectX appelle la fonction DxgkDdiEscape du pilote miniport d’affichage chaque fois que le pilote d’affichage en mode utilisateur doit partager des informations avec le pilote de miniport d’affichage d’une manière qui n’est pas prise en charge par d’autres communications de pilote.

DxgkDdiEscape doit être mis en page.