D3DKMT_ESCAPE structure (d3dkmthk.h)
La structure D3DKMT_ESCAPE décrit les informations échangées avec le pilote de miniport d’affichage.
Syntaxe
typedef struct _D3DKMT_ESCAPE {
[in] D3DKMT_HANDLE hAdapter;
[in] D3DKMT_HANDLE hDevice;
[in] D3DKMT_ESCAPETYPE Type;
[in] D3DDDI_ESCAPEFLAGS Flags;
[in/out] VOID *pPrivateDriverData;
[in] UINT PrivateDriverDataSize;
[in] D3DKMT_HANDLE hContext;
} D3DKMT_ESCAPE;
Membres
[in] hAdapter
Handle de la carte graphique sur laquelle les informations sont échangées.
[in] hDevice
Handle d’un périphérique d’affichage qui est éventuellement spécifié si les informations à échanger sont spécifiques à un appareil particulier.
[in] Type
Valeur de type D3DKMT_ESCAPETYPE qui indique l’échange d’informations avec le pilote miniport d’affichage ou le contrôle des composants en mode noyau. Le tableau suivant répertorie les valeurs possibles.
| Valeur | Signification |
|---|---|
| D3DKMT_ESCAPE_DRIVERPRIVATE (0) | Le membre pPrivateDriverData cible le pilote de miniport d’affichage. Le fournisseur de matériel définit le format des données d’échappement. |
| D3DKMT_ESCAPE_VIDMM (1) | Ne pas utiliser. For testing purposes only. OpenGL ICD contrôle le gestionnaire de mémoire vidéo (qui fait partie de Dxgkrnl.sys). La mémoire tampon vers laquelle pointe pPrivateDriverData contient une structure D3DKMT_VIDMM_ESCAPE qui prend en charge différents types de contrôle du gestionnaire de mémoire vidéo. |
| D3DKMT_ESCAPE_TDRDBGCTRL (2) | Ne pas utiliser. For testing purposes only. L’opération d’échappement permet à l’utilisateur de contrôler le comportement du processus TDR (Timeout Detection and Recovery) du système d’exploitation. Cette fonctionnalité est désactivée par défaut. Pour activer cette fonctionnalité, la valeur de Registre TdrTestMode = TdrTestMode DWORD, qui est stockée dans la clé HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers, doit être définie sur 1. Le membre PrivateDriverDataSize est défini sur sizeof(int). Le membre pPrivateDriverData est défini sur un entier avec une valeur du type d’énumération D3DKMT_TDRDBGCTRLTYPE . |
| D3DKMT_ESCAPE_VIDSCH (3) | Ne pas utiliser. For testing purposes only. OpenGL ICD contrôle le planificateur d’unité de traitement graphique (GPU) (qui fait partie de Dxgkrnl.sys). La mémoire tampon vers laquelle pPrivateDriverData pointe contient une structure D3DKMT_VIDSCH_ESCAPE qui prend en charge le contrôle de préemption et la suspension ou la reprise du planificateur. |
| D3DKMT_ESCAPE_DEVICE (4) | Ne pas utiliser. For testing purposes only. OpenGL ICD contrôle l’appareil d’affichage. La mémoire tampon vers laquelle pPrivateDriverData pointe contient une structure D3DKMT_DEVICE_ESCAPE qui prend en charge l’obtention de la source actuelle de la vidéo à partir de l’allocation primaire. |
| D3DKMT_ESCAPE_DMM (5) | Ne pas utiliser. For testing purposes only. OpenGL ICD contrôle le gestionnaire de mode d’affichage. La mémoire tampon vers laquelle pPrivateDriverData pointe contient une structure D3DKMT_DMM_ESCAPE . |
| D3DKMT_ESCAPE_DEBUG_SNAPSHOT (6) | Ne pas utiliser. For testing purposes only. L’ICD OpenGL récupère une mémoire tampon de débogage instantané. La mémoire tampon vers laquelle pPrivateDriverData pointe contient une structure D3DKMT_DEBUG_SNAPSHOT_ESCAPE . |
| D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7) | Ne pas utiliser. For testing purposes only. OpenGL ICD définit la mise à jour du pilote miniport d’affichage status. |
| D3DKMT_ESCAPE_DRT_TEST (8) | Ne pas utiliser. For testing purposes only. |
| D3DKMT_ESCAPE_DIAGNOSTICS (9) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT (10) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS (11) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_BDD_PNP (12) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_BDD_FALLBACK (13) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG(14) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_MODES_PRUNED_OUT(15) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_WQHL_INFO(16) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_BRIGHTNESS(17) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_EDID_CACHE(18) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_GENERIC_ADAPTER_DIAG_INFO(19) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8.1. |
| D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8.1. |
| D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8.1. |
| D3DKMT_ESCAPE_WIN32K_START(1024) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8. |
| D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8.1. |
| D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8.1. |
| D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028) | Ne pas utiliser. For testing purposes only. Pris en charge à partir de Windows 8.1. |
[in] Flags
Une structure D3DDDI_ESCAPEFLAGS qui indique, dans les indicateurs de champ binaire, comment partager des informations. L’ICD OpenGL doit spécifier l’indicateur de champ de bits HardwareAccess pour indiquer que le pilote miniport d’affichage doit accéder au matériel graphique de telle sorte que le système d’exploitation doit effectuer le deuxième niveau de synchronisation dans le pilote miniport d’affichage pour l’appel DxgkDdiEscape .
[in/out] pPrivateDriverData
Pointeur vers une mémoire tampon allouée par l’ICD OpenGL qui contient des informations que l’ICD OpenGL échange avec le pilote miniport d’affichage ou utilise pour contrôler les composants en mode noyau. Le tableau suivant décrit le contenu de la mémoire tampon vers laquelle pPrivateDriverData pointe, en fonction de la valeur type.
| Valeur du membre Type | Contenu de la mémoire tampon pPrivateDriverData |
|---|---|
| D3DKMT_ESCAPE_DRIVERPRIVATE | Spécifique au pilote. La mémoire tampon n’est utilisable qu’à moins qu’il existe un couplage étroit entre l’ICD OpenGL et le pilote miniport d’affichage. |
| D3DKMT_ESCAPE_VIDMM | Ne pas utiliser. For testing purposes only. Structure D3DKMT_VIDMM_ESCAPE . |
| D3DKMT_ESCAPE_TDRDBGCTRL | Ne pas utiliser. For testing purposes only. Type d’énumération D3DKMT_TDRDBGCTRLTYPE . |
| D3DKMT_ESCAPE_VIDSCH | Ne pas utiliser. For testing purposes only. Structure D3DKMT_VIDSCH_ESCAPE . |
| D3DKMT_ESCAPE_DEVICE | Ne pas utiliser. For testing purposes only. Structure D3DKMT_DEVICE_ESCAPE . |
| D3DKMT_ESCAPE_DMM | Ne pas utiliser. For testing purposes only. Structure D3DKMT_DMM_ESCAPE . |
| D3DKMT_ESCAPE_DEBUG_SNAPSHOT | Ne pas utiliser. For testing purposes only. Structure D3DKMT_DEBUG_SNAPSHOT_ESCAPE . |
[in] PrivateDriverDataSize
Taille, en octets, de la mémoire tampon vers laquelle pPrivateDriverData pointe. L’ICD OpenGL doit spécifier la taille de la mémoire tampon lorsqu’il appelle la fonction D3DKMTEscape .
[in] hContext
Handle dans un contexte qui est éventuellement spécifié si les informations à échanger sont spécifiques à un contexte d’appareil particulier. Si l’ICD OpenGL définit hContext sur une valeur non NULL, l’ICD doit également avoir défini hDevice sur une valeur non NULL, et hDevice doit correspondre à l’appareil propriétaire du contexte.
Remarques
À des fins de test, l’ICD OpenGL peut passer un pointeur vers une structure de D3DKMT_ESCAPE dans un appel à la fonction D3DKMTEscape pour contrôler le gestionnaire de mémoire vidéo et le planificateur GPU (qui font partie de Dxgkrnl.sys) et le comportement du processus TDR du système d’exploitation.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| En-tête | d3dkmthk.h (inclure D3dkmthk.h) |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour