DXGKDDI_ESCAPE fonction de rappel (d3dkmddi.h)

Article
02/06/2025

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 vers un bloc de contexte associé à un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique Microsoft DirectX dans le MiniportDeviceContext paramètre de sortie de la fonction DxgkDdiAddDevice.

[in] pEscape

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

Remarque 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 de retour

DxgkDdiEscape retourne l’une des valeurs suivantes :

Retourner le code	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 de mémoire nécessaire pour qu’elle se termine.
STATUS_PRIVILEGED_INSTRUCTION	DxgkDdiEscape a détecté des instructions non privilégiées (autrement dit, 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 indiquant que le matériel graphique n’a pas pu 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 le du pilote miniport d’affichage DxgkDdiEscape fonction chaque fois que le pilote d’affichage en mode utilisateur doit partager des informations avec le pilote miniport d’affichage d’une manière qui n’est pas prise en charge par le biais d’autres communications de pilote.

DxgkDdiEscape doit être rendu paginable.