Compartilhar via


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

Confira também

IDARG_IN_REPORTCRITICALERROR