Fonction D3DKMTEscape (d3dkmthk.h)

  • Article

La fonction D3DKMTEscape échange des informations avec le pilote de miniport d’affichage.

Syntaxe

NTSTATUS D3DKMTEscape(
  [in] const D3DKMT_ESCAPE *unnamedParam1
);

Paramètres

[in] unnamedParam1

Pointeur vers une structure qui décrit les informations échangées.

Valeur retournée

D3DKMTEscape retourne l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS Les informations ont été partagées avec succès.
STATUS_DEVICE_REMOVED La carte graphique a été arrêtée ou le périphérique d’affichage a été réinitialisé.
STATUS_INVALID_PARAMETER Les paramètres ont été validés et déterminés comme incorrects.
STATUS_NO_MEMORY D3DKMTEscape n’a pas pu se terminer en raison d’une mémoire insuffisante.
STATUS_PRIVILEGED_INSTRUCTION D3DKMTEscape a détecté des instructions non privilégiées (c’est-à-dire des instructions qui accèdent à la mémoire au-delà des privilèges du processus processeur actuel).
STATUS_ILLEGAL_INSTRUCTION D3DKMTEscape a détecté des instructions qui ne peuvent pas être prises en charge par le matériel graphique.

Cette fonction peut également retourner d’autres valeurs NTSTATUS .

Remarques

OpenGL ICD appelle D3DKMTEscape pour échanger des données directement avec le pilote de miniport d’affichage. À des fins de test, openGL ICD peut également appeler D3DKMTEscape pour contrôler le gestionnaire de mémoire vidéo et le planificateur d’unité de traitement graphique (GPU) (qui font partie de Dxgkrnl.sys) et le comportement du processus TDR (Timeout Detection and Recovery) du système d’exploitation.

Les fournisseurs de matériel peuvent utiliser D3DKMTEscape dans leurs ICD OpenGL en tant que mécanisme d’extension. Toutefois, les fournisseurs doivent signaler les extensions nécessaires à Microsoft afin que les extensions puissent être prises en charge en mode natif par le système d’exploitation.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Universal
En-tête d3dkmthk.h (include D3dkmthk.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

D3DKMT_ESCAPE