estrutura D3DKMT_ESCAPE (d3dkmthk.h)

Artigo
02/08/2025

A estrutura D3DKMT_ESCAPE descreve informações trocadas entre um DRIVER de exibição do modo de usuário (UMD) (ou driver cliente) e o KMD (driver de miniporto de exibição) no modo kernel.

Sintaxe

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;

Membros

[in] hAdapter

Um identificador para o adaptador gráfico no qual as informações são trocadas.

[in] hDevice

Um identificador para um dispositivo de exibição que é opcionalmente especificado se as informações a serem trocadas são específicas para um dispositivo específico.

[in] Type

Um valor de enumeração D3DKMT_ESCAPETYPE que indica trocar informações com o KMD ou controlar componentes do modo kernel. A tabela a seguir mostra os valores possíveis.

Value	significado
D3DKMT_ESCAPE_DRIVERPRIVATE (0)	O membro pPrivateDriverData é direcionado ao KMD. O fornecedor de hardware define o formato dos dados de escape.
D3DKMT_ESCAPE_VIDMM (1)	Não use; somente para fins de teste. O driver UMD/cliente controla o gerenciador de memória de vídeo (VidMm). O buffer que pPrivateDriverData aponta para conter uma estrutura D3DKMT_VIDMM_ESCAPE que dá suporte a vários tipos de controle de VidMm.
D3DKMT_ESCAPE_TDRDBGCTRL (2)	Não use; somente para fins de teste. A operação de escape permite que o usuário controle o comportamento do processo de TDR (Detecção e Recuperação de Tempo limite) do sistema operacional. Essa funcionalidade é desabilitada por padrão. Para habilitar essa funcionalidade, o valor do registro TdrTestMode = TdrTestMode DWORD, armazenado na chave HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers, deve ser definido como 1. O membro PrivateDriverDataSize está definido como sizeof(int). O membro pPrivateDriverData é definido como um inteiro com um valor do tipo de enumeração D3DKMT_TDRDBGCTRLTYPE.
D3DKMT_ESCAPE_VIDSCH (3)	Não use; somente para fins de teste. O driver UMD/cliente controla o agendador de GPU (que faz parte do Dxgkrnl). O buffer que pPrivateDriverData aponta para conter uma estrutura D3DKMT_VIDSCH_ESCAPE que dá suporte ao controle de preempção e à suspensão ou retomada do agendador.
D3DKMT_ESCAPE_DEVICE (4)	Não use; somente para fins de teste. O driver UMD/cliente controla o dispositivo de exibição. O buffer que pPrivateDriverData aponta para conter uma estrutura D3DKMT_DEVICE_ESCAPE que dá suporte à obtenção da fonte presente do vídeo da alocação primária.
D3DKMT_ESCAPE_DMM (5)	Não use; somente para fins de teste. O driver UMD/cliente controla o gerenciador de modo de exibição. O buffer que pPrivateDriverData aponta para conter uma estrutura D3DKMT_DMM_ESCAPE.
D3DKMT_ESCAPE_DEBUG_SNAPSHOT (6)	Não use; somente para fins de teste. O driver UMD/cliente recupera um buffer de instantâneo de depuração. O buffer que pPrivateDriverData aponta para conter uma estrutura D3DKMT_DEBUG_SNAPSHOT_ESCAPE.
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7)	Não use; somente para fins de teste. O driver UMD/cliente define o status de atualização kmd.
D3DKMT_ESCAPE_DRT_TEST (8)	Não use; somente para fins de teste.
D3DKMT_ESCAPE_DIAGNOSTICS (9)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT (10)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS (11)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_BDD_PNP (12)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_BDD_FALLBACK (13)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG(14)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_MODES_PRUNED_OUT(15)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_WQHL_INFO(16)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_BRIGHTNESS(17)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_EDID_CACHE(18)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_GENERIC_ADAPTER_DIAG_INFO(19)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20)	Não use; somente para fins de teste. Suporte para começar com Windows 8.1.
D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21)	Não use; somente para fins de teste. Suporte para começar com Windows 8.1.
D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23)	Não use; somente para fins de teste. Suporte para começar com Windows 8.1.
D3DKMT_ESCAPE_WIN32K_START(1024)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025)	Não use; somente para fins de teste. Com suporte a partir do Windows 8.
D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026)	Não use; somente para fins de teste. Suporte para começar com Windows 8.1.
D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027)	Não use; somente para fins de teste. Suporte para começar com Windows 8.1.
D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028)	Não use; somente para fins de teste. Suporte para começar com Windows 8.1.

[in] Flags

Uma estrutura D3DDDI_ESCAPEFLAGS que indica, em sinalizadores de campo de bit, como compartilhar informações. O driver UMD/cliente deve especificar o sinalizador HardwareAccess campo de bits para indicar que o KMD deve acessar o hardware gráfico de modo que o sistema operacional deve executar o segundo nível de de sincronização no KMD para a chamadaDxgkDdiEscape.

hardwareAccess deve ser definido como zero quando a virtualização está sendo usada. Para obter mais informações, consulte de paravirtualização de GPU.

[in/out] pPrivateDriverData

Um ponteiro para um buffer que o driver umd ou cliente aloca que contém uma estrutura de escape de driver conhecida. Essa estrutura contém informações que o driver troca com o KMD ou usa para controlar componentes do modo kernel. A tabela a seguir descreve o conteúdo do buffer que pPrivateDriverData aponta, dependendo do valor de Type.

Valor do tipo	Conteúdo do buffer pPrivateDriverData
D3DKMT_ESCAPE_DRIVERPRIVATE	Específico do driver. O buffer não é utilizável a menos que exista um acoplamento apertado entre o driver UMD/cliente e o KMD.
D3DKMT_ESCAPE_VIDMM	Não use; somente para fins de teste. Uma estrutura D3DKMT_VIDMM_ESCAPE.
D3DKMT_ESCAPE_TDRDBGCTRL	Não use; somente para fins de teste. Um tipo de enumeração D3DKMT_TDRDBGCTRLTYPE.
D3DKMT_ESCAPE_VIDSCH	Não use; somente para fins de teste. Uma estrutura D3DKMT_VIDSCH_ESCAPE.
D3DKMT_ESCAPE_DEVICE	Não use; somente para fins de teste. Uma estrutura D3DKMT_DEVICE_ESCAPE.
D3DKMT_ESCAPE_DMM	Não use; somente para fins de teste. Uma estrutura D3DKMT_DMM_ESCAPE.
D3DKMT_ESCAPE_DEBUG_SNAPSHOT	Não use; somente para fins de teste. Uma estrutura D3DKMT_DEBUG_SNAPSHOT_ESCAPE.

[in] PrivateDriverDataSize

O tamanho, em bytes, do buffer que pPrivateDriverData aponta para. O driver UMD/cliente deve especificar o tamanho do buffer quando ele chama a funçãoD3DKMTEscape.

[in] hContext

Um identificador para um contexto que é opcionalmente especificado se as informações a serem trocadas são específicas para um contexto de dispositivo específico. Se o driver umd/cliente definir hContext para um valor não NULL, o driver também deverá ter definido hDevice para um valor não NULL e hDevice deve corresponder ao dispositivo que possui o contexto.