Compartir a través de

Función de devolución de llamada pHalSetSystemInformation (ntddk.h)

  • Artículo

Registre el controlador MCA con hal.

Sintaxis

pHalSetSystemInformation Phalsetsysteminformation;

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

Parámetros

[in] InformationClass

HalMcaRegisterDriver para registrar rutinas de devolución de llamada del controlador MCA con HAL. Hay dos rutinas de devolución de llamada: ExceptionCallback y DpcCallback. Se llama a la rutina ExceptionCallback durante el procesamiento de errores no reiniciable del controlador de excepciones de comprobación de máquina (MCE), antes de que se produzca una comprobación de errores para el sistema. Se llama a la rutina DpcCallback cuando se puede reiniciar el error de MCA. Para los sistemas Itanium, especifique HalCmcRegisterDriver para registrar la rutina DpcCallback del error de CPU corregido de un controlador y HalCpeRegisterDriver para registrar el error de plataforma corregido de un controlador DpcCallback.

[in] BufferSize

Tamaño, en bytes, del búfer que proporciona el autor de la llamada.

[out] Buffer

Puntero a un búfer proporcionado por el autor de la llamada de tipo MCA_DRIVER_INFO, que se define como se indica a continuación.

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;

Esta estructura contiene los siguientes miembros:

  • ExceptionCallback

    La rutina proporcionada por el controlador que se va a llamar cuando se produce una excepción de comprobación de máquina (MCE) para errores no corregidos. Un controlador no puede usar explícitamente ningún servicio de kernel ni rutinas de bloqueo de número. El controlador está restringido a las mismas restricciones que un controlador que funciona en el IRQL más alto.

  • DpcCallback

    Rutina proporcionada por el controlador que se llama para los errores corregidos que provocaron la excepción de comprobación de máquina (MCE). Se debe llamar a esta rutina en DISPATCH_LEVEL.

  • DeviceContext

    Contexto específico del dispositivo para este controlador MCA.

Valor devuelto

Devuelve STATUS_SUCCESS si el registro se realiza correctamente.

Observaciones

Se debe llamar a HalSetSystemInformation antes de que un controlador MCA pueda usar cualquiera de las demás rutinas de interfaz. Solo se puede registrar un controlador MCA con el HAL en cualquier momento dado.

Windows Vista y versiones posteriores de Windows no admiten el tipo de informe de arquitectura de comprobación de máquinas (MCA) y excepción de comprobación de máquina (MCE) que se describe en este tema. Los informes de MCA y MCE se admiten a través de arquitectura de errores de hardware de Windows (WHEA) en su lugar.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de ntddk.h (incluya Ntddk.h)