DXGKCB_INVALIDATEHWCONTEXT função de retorno de chamada (d3dkmddi.h)
Um KMD (driver gráfico no modo kernel) chama DxgkcbInvalidatehwcontext para invalidar um contexto de hardware.
Sintaxe
DXGKCB_INVALIDATEHWCONTEXT DxgkcbInvalidatehwcontext;
NTSTATUS DxgkcbInvalidatehwcontext(
[in] IN_CONST_PDXGKARGCB_INVALIDATEHWCONTEXT unnamedParam1
)
{...}
Parâmetros
[in] unnamedParam1
Ponteiro para uma estrutura DXGKARGCB_INVALIDATEHWCONTEXT que contém informações para Dxgkrnl a serem usadas para invalidar o contexto de hardware.
Valor de retorno
DxgkcbInvalidatehwcontext retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, ele retornará um código de erro NTSTATUS apropriado.
Observações
O KMD chama DxgkcbInvalidatehwcontext para notificar o sistema quando o estado e os recursos associados a um contexto de hardware não forem mais válidos ou consistentes, exigindo que o contexto seja redefinido ou reinicializado antes que ele possa ser usado novamente. Um contexto precisa ser invalidado no caso de uma operação de redefinição do mecanismo de hardware que possa ser devido a uma variedade de motivos, como recuperação de uma falha ou reconfiguração dos recursos de GPU.
Dxgkrnl marca o contexto como inválido para que ele não esteja mais agendado para execução na GPU. Em seguida, ele inicia qualquer limpeza necessária, como liberar recursos associados ao contexto ou redefinir qualquer estado associado ao contexto.
DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, defina os membros do DXGKARGCB_INVALIDATEHWCONTEXT e chame DxgkCbInvalidateHwContext por meio do DXGKRNL_INTERFACE.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 1703 (WDDM 2.2) |
| cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |