функция обратного вызова 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, если регистрация выполнена успешно.

Замечания

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

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

Требования