estrutura D3DKMT_ESCAPE (d3dkmthk.h)

Artigo
10/23/2024

A estrutura D3DKMT_ESCAPE descreve as informações trocadas com o driver de miniporto de exibição.

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 do tipo D3DKMT_ESCAPETYPE que indica trocar informações com o driver de miniporto de exibição 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 driver de miniporto de exibição. O fornecedor de hardware define o formato dos dados de escape.
D3DKMT_ESCAPE_VIDMM (1)	Não use. Somente para fins de teste. O OpenGL ICD controla o gerenciador de memória de vídeo (que faz parte do Dxgkrnl.sys). O buffer para o qual pPrivateDriverData aponta contém uma estrutura D3DKMT_VIDMM_ESCAPE que dá suporte a vários tipos de controle do gerenciador de memória de vídeo.
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 é 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 OpenGL ICD controla o agendador de GPU (unidade de processamento gráfico) (que faz parte do Dxgkrnl.sys). O buffer para o qual pPrivateDriverData aponta contém 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 OpenGL ICD controla o dispositivo de exibição. O buffer para o qual pPrivateDriverData aponta contém uma estrutura D3DKMT_DEVICE_ESCAPE que dá suporte à obtenção da origem do vídeo presente da alocação primária.
D3DKMT_ESCAPE_DMM (5)	Não use. Somente para fins de teste. O OpenGL ICD controla o gerenciador de modo de exibição. O buffer para o qual pPrivateDriverData aponta contém uma estrutura D3DKMT_DMM_ESCAPE.
D3DKMT_ESCAPE_DEBUG_SNAPSHOT (6)	Não use. Somente para fins de teste. O OpenGL ICD recupera um buffer de instantâneo de depuração. O buffer para o qual pPrivateDriverData aponta contém uma estrutura D3DKMT_DEBUG_SNAPSHOT_ESCAPE.
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7)	Não use. Somente para fins de teste. O ICD do OpenGL define o status de atualização do driver de miniporto de exibição.
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 OpenGL ICD deve especificar o sinalizador HardwareAccess de campo de bits para indicar que o driver de miniporto de exibição deve acessar o hardware gráfico de forma que o sistema operacional deve executar o segundo nível de sincronização segundo no driver de miniporto de exibição para a chamada DxgkDdiEscape .

[in/out] pPrivateDriverData

Um ponteiro para um buffer que o OpenGL ICD aloca que contém informações que o OpenGL ICD troca com o driver de miniporto de exibição 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 membro Type	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 ICD opengl e o driver de miniporto de exibição.
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 ICD do OpenGL deve especificar o tamanho do buffer quando ele chama a função D3DKMTEscape .

[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 ICD opengl definir hContext para um valor não NULL, o ICD também deverá ter definido hDevice como um valor não NULL e hDevice deve corresponder ao dispositivo que possui o contexto.

Observações

Para fins de teste, a ICD do OpenGL pode passar um ponteiro para uma estrutura de D3DKMT_ESCAPE em uma chamada para a função D3DKMTEscape para controlar o gerenciador de memória de vídeo e o agendador de GPU (que fazem parte do Dxgkrnl.sys) e o comportamento do processo TDR do sistema operacional.