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

Artigo
02/06/2025

A função DxgkDdiEscape compartilha informações com o driver de exibição no 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 na função MiniportDeviceContext da função DxgkDdiAddDevice.

[in] pEscape

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

Observação 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á.

Valor de retorno

DxgkDdiEscape retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	O DxgkDdiEscape compartilhou informações com êxito.
STATUS_INVALID_PARAMETER	Os parâmetros passados para DxgkDdiEscape continham erros que o impediram de concluir.
STATUS_NO_MEMORY	O DxgkDdiEscape não pôde alocar a memória necessária para que ela fosse concluída.
STATUS_PRIVILEGED_INSTRUCTION	O DxgkDdiEscape detectou instruções nãoprivilegadas (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 no modo de usuário que iniciou a chamada para DxgkDdiEscape.

Observações

O subsistema de kernel de elementos gráficos DirectX chama a função DxgkDdiEscape do driver de miniporto de exibição sempre que o driver de exibição no 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 ficar paginável.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Consulte também

DXGKARG_ESCAPE

DxgkDdiAddDevice

pfnEscapeCb

Compartilhar via