Função IddCxReportCriticalError (iddcx.h)
IddCxReportCriticalError é uma função de retorno de chamada do sistema operacional chamada por um driver de exibição indireto (IDD) para relatar um erro crítico.
Sintaxe
NTSTATUS IddCxReportCriticalError(
IDDCX_ADAPTER AdapterObject,
const IDARG_IN_REPORTCRITICALERROR *pInArgs
);
Parâmetros
AdapterObject
Um objeto IDDCX_ADAPTER do adaptador no qual ocorreu o erro crítico. Se o erro ocorreu antes de um IDDCX_ADAPTER ser criado, a IDD deverá passar nullptr
.
pInArgs
Ponteiro para uma estrutura IDARG_IN_REPORTCRITICALERROR que contém o código de erro do erro crítico.
Retornar valor
Se a rotina for bem-sucedida, ela nunca retornará ao driver porque o processo do driver será encerrado.
Comentários
Quando uma IDD chama IddCxCriticalError, o sistema operacional fará o seguinte:
- Verifique o driver com o seguinte código de verificação de bugs:
(pInArgs->MajorErrorCode+0x100 << 8) + pInArgs->MinorErrorCode
. É recomendável que o driver use uma combinação exclusiva de um código principal e um código secundário para que esses casos possam ser identificados em falhas e relatórios watson. - Encerre o processo de driver e reinicie de acordo com a política de reinicialização do driver UMDF.
- Se o chamador for uma ID remota, desconecte a sessão do usuário.
À medida que um despejo de memória no modo de usuário é gerado, o driver deve colocar qualquer informação de depuração útil na pilha da função que chamou IddCxCriticalError.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 10 |
Cabeçalho | iddcx.h |