pHalSetSystemInformation, fonction de rappel (ntddk.h)

Article
02/07/2025

Inscrivez le pilote MCA auprès de HAL.

Syntaxe

pHalSetSystemInformation Phalsetsysteminformation;

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

Paramètres

[in] InformationClass

HalMcaRegisterDriver pour inscrire les routines de rappel du pilote MCA auprès de hal. Il existe deux routines de rappel : ExceptionCallback et DpcCallback. La routine ExceptionCallback est appelée pendant le traitement des erreurs non redémarrables du gestionnaire Machine Check Exception (MCE), avant qu’elle n’émet une vérification de bogue pour le système. La routine DpcCallback est appelée lorsque l’erreur MCA est redémarrée. Pour les systèmes Itanium, spécifiez HalCmcRegisterDriver pour inscrire la routine DpcCallback d’erreur de processeur corrigée d’un pilote et HalCpeRegisterDriver pour inscrire l’erreur de plateforme corrigée DpcCallback d’un pilote.

[in] BufferSize

Taille, en octets, de la mémoire tampon que l’appelant fournit.

[out] Buffer

Pointeur vers une mémoire tampon fournie par l’appelant de type MCA_DRIVER_INFO, qui est définie comme suit.

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;

Cette structure contient les membres suivants :

ExceptionCallback

La routine fournie par le pilote à appeler lorsque l’exception mcE (Machine Check Exception) se produit pour les erreurs non détectées. Un pilote ne peut pas utiliser explicitement les services de noyau ou les routines de verrouillage de spin. Le gestionnaire est limité aux mêmes contraintes qu’un pilote qui fonctionne au niveau irQL le plus élevé.
DpcCallback

Routine fournie par le pilote qui est appelée pour les erreurs corrigées qui ont provoqué l’exception de vérification de machine (MCE). Cette routine doit être appelée à DISPATCH_LEVEL.
DeviceContext

Contexte spécifique à l’appareil pour ce pilote MCA.

Valeur de retour

Retourne STATUS_SUCCESS si l’inscription réussit.

Remarques

HalSetSystemInformation doit être appelé avant qu’un pilote MCA puisse utiliser l’une des autres routines d’interface. Un seul pilote MCA peut être inscrit auprès du HAL à tout moment.

Windows Vista et versions ultérieures de Windows ne prennent pas en charge le type de rapports MCA (Machine Check Architecture) et Machine Check Exception (MCE) décrits dans cette rubrique. Les rapports MCA et MCE sont pris en charge via l’architecture d’erreur matérielle Windows (WHEA) à la place.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	ntddk.h (include Ntddk.h)

Partager via