Функция обратного вызова pHalSetSystemInformation (ntddk.h)

Зарегистрируйте драйвер MCA в HAL.

Синтаксис

pHalSetSystemInformation Phalsetsysteminformation;

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

Параметры

[in] InformationClass

HalMcaRegisterDriver для регистрации процедур обратного вызова драйвера MCA в HAL. Существует две подпрограммы обратного вызова: ExceptionCallback и DpcCallback. Подпрограмма ExceptionCallback вызывается во время обработки необзагружаемых ошибок обработчика исключения проверки компьютера (MCE), прежде чем она выдает проверка ошибок для системы. Подпрограмма DpcCallback вызывается при перезапуске ошибки MCA. Для систем Itanium укажите HalCmcRegisterDriver, чтобы зарегистрировать исправленную ошибку ЦП драйвера DpcCallback, и HalCpeRegisterDriver, чтобы зарегистрировать исправленную ошибку платформы драйвера DpcCallback.

[in] BufferSize

Размер (в байтах) буфера, который предоставляет вызывающий объект.

[out] Buffer

Указатель на буфер, предоставляемый вызывающим объектом, типа MCA_DRIVER_INFO, который определяется следующим образом.

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;

Эта структура содержит следующие элементы:

• ExceptionCallback

  Подпрограмма, предоставляемая драйвером, которая вызывается при возникновении исключения проверки компьютера (MCE) для неисправных ошибок. Драйвер явно не может использовать какие-либо службы ядра или подпрограммы спин-блокировки. Обработчик ограничен теми же ограничениями, что и драйвер, работающий с максимальным значением IRQL.

• DpcCallback

  Подпрограмма, предоставляемая драйвером, которая вызывается для исправленных ошибок, вызвавших исключение проверки компьютера (MCE). Эта подпрограмма должна вызываться в DISPATCH_LEVEL.

• DeviceContext

  Контекст устройства для этого драйвера MCA.

Возвращаемое значение

Возвращает STATUS_SUCCESS, если регистрация выполнена успешно.

Комментарии

Прежде чем драйвер MCA сможет использовать любые другие подпрограммы интерфейса, необходимо вызвать HalSetSystemInformation. Только один драйвер MCA можно зарегистрировать в HAL в любой момент времени.

Windows Vista и более поздние версии Windows не поддерживают отчеты об использовании архитектуры проверки компьютера (MCA) и исключения проверки компьютера (MCE), описанные в этом разделе. Вместо этого отчеты MCA и MCE поддерживаются с помощью архитектуры аппаратных ошибок Windows (WHEA).

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	ntddk.h (включая Ntddk.h)