Compartilhar 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 chegou à fila de hardware porque o dispositivo entrou em um estado de erro. Esse estado de erro normalmente é causado por um evento 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 kernel de elementos gráficos DirectX no parâmetro de saída 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.

Retornar valor

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.

Comentários

Nota O subsistema de kernel de elementos gráficos DirectX chamará essa função somente se o DXGK_VIDSCHCAPS. O membro 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 memória, o erro é observado pela mensagem BugCheck 0x119, 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
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Área de Trabalho
Cabeçalho d3dkmddi.h
IRQL PASSIVE_LEVEL

Confira também

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice