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

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 erro não reiniciado do manipulador MCE (Exceção de Verificação de Máquina), antes de emitir um bug marcar para o sistema. A rotina DpcCallback é chamada quando o erro MCA é reiniciado. Para sistemas Itanium, especifique HalCmcRegisterDriver para registrar a rotina de erro de CPU corrigida de um driver DpcCallback 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 MCE (Exceção de Verificação de Computador). Essa rotina deve ser chamada em DISPATCH_LEVEL.

• DeviceContext

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

Retornar valor

Retorna STATUS_SUCCESS se o registro for bem-sucedido.

Comentários

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órios MCA (Machine Check Architecture) e MCE (Machine Check Exception) descritos neste tópico. Os relatórios MCA e MCE têm suporte por meio da WHEA (Arquitetura de Erros de Hardware) do Windows .

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	ntddk.h (inclua Ntddk.h)