Fonction D3DKMTEscape (d3dkmthk.h)
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 |