D3DKMTEscape, fonction (d3dkmthk.h)
La fonction D3DKMTEscape échange des informations entre le pilote d’affichage en mode utilisateur (UMD) (ou pilote client) et le pilote miniport d’affichage en mode noyau (KMD).
Syntaxe
NTSTATUS D3DKMTEscape(
[in] const D3DKMT_ESCAPE *unnamedParam1
);
Paramètres
[in] unnamedParam1
Pointeur vers une structure D3DKMT_ESCAPE qui décrit les informations échangées.
Valeur de retour
D3DKMTEscape retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | Les informations ont été partagées avec succès. |
| STATUS_DEVICE_REMOVED | La carte graphique a été arrêtée ou l’appareil 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 des instructions non privilégiées détectées (autrement dit, des instructions qui accèdent à la mémoire au-delà du privilège du processus uc actuel). |
| STATUS_ILLEGAL_INSTRUCTION | D3DKMTEscape 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
Le pilote UMD ou client appelle D3DKMTEscape pour échanger des données directement avec le KMD. À des fins de test, D3DKMTEscape peut être appelé pour contrôler le gestionnaire de mémoire vidéo (VidMm) et le planificateur GPU (qui font partie de Dxgkrnl.sys) et le comportement du processus de détection et de récupération du système d’exploitation (TDR).
Les fournisseurs de matériel peuvent utiliser D3DKMTEscape dans leurs pilotes comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Universel |
| d’en-tête | d3dkmthk.h (include D3dkmthk.h) |
| bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |