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

Artigo
02/23/2024

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.