structure D3DKMT_ESCAPE (d3dkmthk.h)

Article
10/23/2024

La structure D3DKMT_ESCAPE décrit les informations échangées avec le pilote 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 vers l’adaptateur graphique sur lequel les informations sont échangées.

[in] hDevice

Handle vers un appareil 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 soit pour échanger des informations avec le pilote miniport d’affichage, soit pour contrôler les composants en mode noyau. Le tableau suivant présente les valeurs possibles.

valeur	Signification
D3DKMT_ESCAPE_DRIVERPRIVATE (0)	Le membre pPrivateDriverData est ciblé sur le pilote miniport d’affichage. Le fournisseur de matériel définit le format des données d’échappement.
D3DKMT_ESCAPE_VIDMM (1)	N’utilisez pas. À des fins de test uniquement. OpenGL ICD contrôle le gestionnaire de mémoire vidéo (qui fait partie de Dxgkrnl.sys). Mémoire tampon que pPrivateDriverData pointe pour contenir 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)	N’utilisez pas. À des fins de test uniquement. 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, 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)	N’utilisez pas. À des fins de test uniquement. OpenGL ICD contrôle le planificateur d’unité de traitement graphique (GPU) (qui fait partie de Dxgkrnl.sys). Mémoire tampon que pPrivateDriverData pointe pour contenir une structure D3DKMT_VIDSCH_ESCAPE qui prend en charge le contrôle de préemption et suspend ou reprend le planificateur.
D3DKMT_ESCAPE_DEVICE (4)	N’utilisez pas. À des fins de test uniquement. OpenGL ICD contrôle l’appareil d’affichage. Mémoire tampon pointée par pPrivateDriverData pour contenir une structure D3DKMT_DEVICE_ESCAPE qui prend en charge l’obtention de la source actuelle de la vidéo à partir de l’allocation principale.
D3DKMT_ESCAPE_DMM (5)	N’utilisez pas. À des fins de test uniquement. OpenGL ICD contrôle le gestionnaire de mode d’affichage. Mémoire tampon que pPrivateDriverData pointe pour contenir une structure D3DKMT_DMM_ESCAPE.
D3DKMT_ESCAPE_DEBUG_SNAPSHOT (6)	N’utilisez pas. À des fins de test uniquement. OpenGL ICD récupère une mémoire tampon d’instantané de débogage. Mémoire tampon qui pointe vers pPrivateDriverData pour contenir une structure D3DKMT_DEBUG_SNAPSHOT_ESCAPE.
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7)	N’utilisez pas. À des fins de test uniquement. OpenGL ICD définit l’état de mise à jour du pilote miniport d’affichage.
D3DKMT_ESCAPE_DRT_TEST (8)	N’utilisez pas. À des fins de test uniquement.
D3DKMT_ESCAPE_DIAGNOSTICS (9)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT (10)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS (11)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_BDD_PNP (12)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_BDD_FALLBACK (13)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG(14)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_MODES_PRUNED_OUT(15)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_WQHL_INFO(16)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_BRIGHTNESS(17)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_EDID_CACHE(18)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_GENERIC_ADAPTER_DIAG_INFO(19)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.1.
D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.1.
D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.1.
D3DKMT_ESCAPE_WIN32K_START(1024)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.
D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.1.
D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.1.
D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028)	N’utilisez pas. À des fins de test uniquement. Prise en charge à partir de Windows 8.1.

[in] Flags

Structure D3DDDI_ESCAPEFLAGS qui indique, dans les indicateurs de champ binaire, comment partager des informations. L’ICD OpenGL doit spécifier l’indicateur de HardwareAccess bit-field pour indiquer que le pilote de miniport d’affichage doit accéder au matériel graphique de telle sorte que le système d’exploitation doit effectuer le second niveau de synchronisation dans le pilote de miniport d’affichage pour l’appel DxgkDdiEscape.

[in/out] pPrivateDriverData

Pointeur vers une mémoire tampon que l’ICD OpenGL alloue 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 de Type.

valeur du membre de type	contenu de la mémoire tampon pPrivateDriverData
D3DKMT_ESCAPE_DRIVERPRIVATE	Spécifique au pilote. La mémoire tampon n’est pas utilisable, sauf si un couplage serré existe entre l’ICD OpenGL et le pilote miniport d’affichage.
D3DKMT_ESCAPE_VIDMM	N’utilisez pas. À des fins de test uniquement. Structure D3DKMT_VIDMM_ESCAPE.
D3DKMT_ESCAPE_TDRDBGCTRL	N’utilisez pas. À des fins de test uniquement. Type d’énumération D3DKMT_TDRDBGCTRLTYPE.
D3DKMT_ESCAPE_VIDSCH	N’utilisez pas. À des fins de test uniquement. Structure D3DKMT_VIDSCH_ESCAPE.
D3DKMT_ESCAPE_DEVICE	N’utilisez pas. À des fins de test uniquement. Structure D3DKMT_DEVICE_ESCAPE.
D3DKMT_ESCAPE_DMM	N’utilisez pas. À des fins de test uniquement. Structure D3DKMT_DMM_ESCAPE.
D3DKMT_ESCAPE_DEBUG_SNAPSHOT	N’utilisez pas. À des fins de test uniquement. 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’elle appelle la fonction D3DKMTEscape.

[in] hContext

Handle vers 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 à 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.