Partilhar via


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

Limpa os recursos internos associados a um pacote de DMA (acesso direto à memória) que estava na fila de software do agendador de GPU, mas nunca atingiu a fila de hardware porque o dispositivo entrou em um estado de erro. Esse estado de erro normalmente é causado por um evento de TDR (Detecção e Recuperação de Tempo Limite).

Sintaxe

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

NTSTATUS DxgkddiCancelcommand(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_CANCELCOMMAND pCancelCommand
)
{...}

Parâmetros

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 DirectX na função MiniportDeviceContext da função DxgkDdiAddDevice.

pCancelCommand

Um ponteiro para uma estrutura de DXGKARG_CANCELCOMMAND que especifica os recursos a serem limpos depois que um comando é removido da fila de hardware.

Valor de retorno

Retorna STATUS_SUCCESS após a conclusão bem-sucedida. Se o driver retornar um código de erro, o sistema operacional fará com que ocorra uma verificação de bugs do sistema. Para obter mais informações, consulte a seção Comentários a seguir.

Observações

Observação o subsistema de kernel de elementos gráficos DirectX chamará essa função somente se o DXGK_VIDSCHCAPS.membro do CancelCommandAware está definido.
 
Se o driver retornar um código de erro, o subsistema de kernel de elementos gráficos DirectX fará com que ocorra uma verificação de bugs do sistema. Em um arquivo de despejo de falha, o erro é observado pela mensagem 0x119BugCheck, que tem os quatro parâmetros a seguir.
  1. 0x9
  2. O código de erro NTSTATUS retornado da chamada de driver com falha
  3. Um ponteiro para a estrutura DXGKARG_CANCELCOMMAND
  4. Um ponteiro para uma estrutura de dados do agendador interno

Requisitos

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

Consulte também

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice