estrutura D3DKMT_ESCAPE (d3dkmthk.h)

Artigo
05/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;
  void               D3DKMT_PTR(
    VOID               *unnamedParam1,
    pPrivateDriverData unnamedParam2
  );
  [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.

Valor	Significado
D3DKMT_ESCAPE_DRIVERPRIVATE (0)	O membro pPrivateDriverData é direcionado para o 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 está desabilitada por padrão. Para habilitar essa funcionalidade, o valor do registro TdrTestMode = TdrTestMode DWORD, que é 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 fonte presente do vídeo 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 OpenGL ICD define a atualização do driver de miniporta de exibição status.
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 começando com Windows 8.
D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20)	Não use. Somente para fins de teste. Com suporte a partir de Windows 8.1.
D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21)	Não use. Somente para fins de teste. Com suporte a partir de Windows 8.1.
D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23)	Não use. Somente para fins de teste. Com suporte a partir de Windows 8.1.
D3DKMT_ESCAPE_WIN32K_START(1024)	Não use. Somente para fins de teste. Com suporte começando com Windows 8.
D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024)	Não use. Somente para fins de teste. Com suporte começando com Windows 8.
D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025)	Não use. Somente para fins de teste. Com suporte começando com Windows 8.
D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026)	Não use. Somente para fins de teste. Com suporte a partir de Windows 8.1.
D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027)	Não use. Somente para fins de teste. Com suporte a partir de Windows 8.1.
D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028)	Não use. Somente para fins de teste. Com suporte a partir de 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 de campo de bits HardwareAccess 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 no driver de miniporto de exibição para a chamada DxgkDdiEscape .

void D3DKMT_PTR( VOID *unnamedParam1, pPrivateDriverData unnamedParam2)

[in] PrivateDriverDataSize

O tamanho, em bytes, do buffer para o qual pPrivateDriverData aponta. O OpenGL ICD deve especificar o tamanho do buffer ao chamar a função D3DKMTEscape .

[in] hContext

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

Comentários

Para fins de teste, o OpenGL ICD pode passar um ponteiro para uma estrutura 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.