Função de retorno de chamada pHalSetSystemInformation (ntddk.h)

Artigo
02/07/2025

Registre o driver MCA com o HAL.

Sintaxe

pHalSetSystemInformation Phalsetsysteminformation;

NTSTATUS Phalsetsysteminformation(
  [in]  HAL_SET_INFORMATION_CLASS InformationClass,
  [in]  ULONG BufferSize,
  [out] PVOID Buffer
)
{...}

Parâmetros

[in] InformationClass

O HalMcaRegisterDriver para registrar as rotinas de retorno de chamada do driver MCA com o HAL. Há duas rotinas de retorno de chamada: ExceptionCallback e DpcCallback. A rotina ExceptionCallback é chamada durante o processamento de erros não reiniciados do manipulador de Exceção de Verificação de Máquina (MCE), antes de emitir uma verificação de bugs para o sistema. A rotina DpcCallback é chamada quando o erro MCA é reiniciado. Para sistemas itanium, especifique HalCmcRegisterDriver para registrar a rotina de DpcCallback de erro de CPU corrigida de um driver e HalCpeRegisterDriver para registrar o erro de plataforma corrigido de um driver DpcCallback.

[in] BufferSize

O tamanho, em bytes, do buffer fornecido pelo chamador.

[out] Buffer

Um ponteiro para um buffer fornecido pelo chamador do tipo MCA_DRIVER_INFO, que é definido da seguinte maneira.

typedef struct _MCA_DRIVER_INFO {
  PDRIVER_EXCPTN_CALLBACK  ExceptionCallback; // NULL for Itanium corrected error registration
  PKDEFERRED_ROUTINE  DpcCallback;
  PVOID  DeviceContext;
} MCA_DRIVER_INFO, *PMCA_DRIVER_INFO;

Essa estrutura contém os seguintes membros:

ExceptionCallback

A rotina fornecida pelo driver a ser chamada quando a MCE (Exceção de Verificação de Máquina) ocorre para erros não corrigidos. Um driver explicitamente não pode usar nenhum serviço de kernel ou rotinas de bloqueio de rotação. O manipulador é restrito às mesmas restrições que um driver que opera no IRQL mais alto.
DpcCallback

Uma rotina fornecida pelo driver que é chamada para erros corrigidos que causaram a Exceção de Verificação de Máquina (MCE). Essa rotina deve ser chamada no DISPATCH_LEVEL.
DeviceContext

O contexto específico do dispositivo para esse driver MCA.

Valor de retorno

Retorna STATUS_SUCCESS se o registro for bem-sucedido.

Observações

HalSetSystemInformation deve ser chamado antes que um driver MCA possa usar qualquer uma das outras rotinas de interface. Somente um driver MCA pode ser registrado com o HAL a qualquer momento.

O Windows Vista e versões posteriores do Windows não dão suporte ao tipo de relatório MCA (Machine Check Architecture) e MCE (Machine Check Exception) descritos neste tópico. Os relatórios MCA e MCE têm suporte por meio WHEA (Arquitetura de Erro de Hardware do Windows).

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	ntddk.h (inclua Ntddk.h)

Partilhar via