Partager via


DXGKDDI_ESCAPE fonction de rappel (d3dkmddi.h)

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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dkmddi.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGKARG_ESCAPE

DxgkDdiAddDevice

pfnEscapeCb