DXGKDDI_ESCAPE função de retorno de chamada (d3dkmddi.h)

A função DxgkDdiEscape compartilha informações com o driver de exibição do modo de usuário.

Sintaxe

DXGKDDI_ESCAPE DxgkddiEscape;

NTSTATUS DxgkddiEscape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_ESCAPE pEscape
)
{...}

Parâmetros

[in] hAdapter

Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .

[in] pEscape

Um ponteiro para uma estrutura DXGKARG_ESCAPE que contém informações sobre as informações compartilhadas.

Nota Para que a chamada DxgkDdiEscape seja feita no segundo nível, o sinalizador HardwareAccess deve ser definido dentro da estrutura D3DDDI_ESCAPEFLAGS que é membro do DXGKARG_ESCAPE. Se esse sinalizador não estiver definido, a chamada falhará.

 

Retornar valor

DxgkDdiEscape retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	DxgkDdiEscape compartilhou com êxito as informações.
STATUS_INVALID_PARAMETER	Os parâmetros passados para DxgkDdiEscape continham erros que impediram a conclusão.
STATUS_NO_MEMORY	O DxgkDdiEscape não pôde alocar memória necessária para que ela fosse concluída.
STATUS_PRIVILEGED_INSTRUCTION	DxgkDdiEscape detectou instruções não privilegiadas (ou seja, instruções que acessam a memória além do privilégio do processo atual da unidade de processamento central [CPU]).
STATUS_ILLEGAL_INSTRUCTION	O DxgkDdiEscape detectou instruções de que o hardware gráfico não podia dar suporte.
STATUS_GRAPHICS_DRIVER_MISMATCH	O driver de miniporto de exibição não é compatível com o driver de exibição do modo de usuário que iniciou a chamada para DxgkDdiEscape.

Comentários

O subsistema de kernel de elementos gráficos DirectX chama a função DxgkDdiEscape do driver de miniporte de exibição sempre que o driver de exibição do modo de usuário deve compartilhar informações com o driver de miniporto de exibição de uma maneira que não tenha suporte por meio de outras comunicações do driver.

DxgkDdiEscape deve se tornar paginável.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Confira também

DXGKARG_ESCAPE

DxgkDdiAddDevice

pfnEscapeCb