DXGKDDI_RESETENGINE função de retorno de chamada (d3dkmddi.h)
O agendador de GPU do driver de porta de exibição chama a função DxgkDdiResetEngine do driver de porta de exibição para redefinir um nó ativo em um adaptador de exibição físico quando o agendador detecta uma condição de tempo limite no adaptador.
Sintaxe
DXGKDDI_RESETENGINE DxgkddiResetengine;
NTSTATUS DxgkddiResetengine(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_RESETENGINE pResetEngine
)
{...}
Parâmetros
hAdapter
[in] Um identificador para um bloco de contexto associado a um adaptador de exibição. O KMD forneceu anteriormente esse identificador para Dxgkrnl no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .
pResetEngine
[entrada/saída] Uma estrutura DXGKARG_RESETENGINE que especifica o nó a ser redefinido e fornece um identificador de cerca para o último pacote anulado.
Retornar valor
DxgkDdiResetEngine retornará STATUS_SUCCESS se a função for bem-sucedida. Caso contrário, essa função retornará um dos códigos de erro definidos em Ntstatus.h.
Comentários
O KMD deve retornar de uma chamada para essa função somente quando todos os seguintes critérios forem atendidos:
- A operação de redefinição foi concluída.
- Nada permanece na fila de hardware do adaptador físico.
- Os nós especificados estão prontos para aceitar novos pacotes.
Essa função deve ser tornada paginável.
O sistema operacional garante que essa função siga o modo de sincronização de primeiro nível.
Para obter mais informações, consulte Alterações de TDR em Windows 8.
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 |