Função D3DKMTEscape (d3dkmthk.h)

A função D3DKMTEscape troca informações entre o 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

NTSTATUS D3DKMTEscape(
  [in] const D3DKMT_ESCAPE *unnamedParam1
);

Parâmetros

[in] unnamedParam1

Ponteiro para uma estrutura de D3DKMT_ESCAPE que descreve as informações trocadas.

Valor de retorno

D3DKMTEscape retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	As informações foram compartilhadas com êxito.
STATUS_DEVICE_REMOVED	O adaptador gráfico foi interrompido ou o dispositivo de exibição foi redefinido.
STATUS_INVALID_PARAMETER	Os parâmetros foram validados e determinados como incorretos.
STATUS_NO_MEMORY	D3DKMTEscape não pôde ser concluída devido à memória insuficiente.
STATUS_PRIVILEGED_INSTRUCTION	D3DKMTEscape detectou instruções não privilegiadas (ou seja, instruções que acessam a memória além do privilégio do processo de CPU atual).
STATUS_ILLEGAL_INSTRUCTION	D3DKMTEscape instruções detectadas que não podem ser suportadas pelo hardware gráfico.

Essa função também pode retornar outros valores de NTSTATUS.

Observações

A UMD ou o driver cliente chama D3DKMTEscape para trocar dados diretamente com o KMD. Para fins de teste, D3DKMTEscape podem ser chamados para controlar o gerenciador de memória de vídeo (VidMm) e o agendador de GPU (que fazem parte do Dxgkrnl.sys) e o comportamento do processo de TDR (Detecção e Recuperação de Tempo limite) do sistema operacional.

Os fornecedores de hardware podem usar D3DKMTEscape em seus drivers como um mecanismo de extensão. No entanto, os fornecedores devem relatar as extensões necessárias à Microsoft para que as extensões possam ter suporte nativo do sistema operacional.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Universal
cabeçalho	d3dkmthk.h (inclua D3dkmthk.h)
biblioteca	Gdi32.lib
de DLL	Gdi32.dll

Consulte também

D3DKMT_ESCAPE