Fonction de rappel pHalSetSystemInformation (ntddk.h)

  • Article

Inscrivez le pilote MCA avec 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 du 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 De vérification de machine (MCE), avant qu’elle ne génère un bogue case activée pour le système. La routine DpcCallback est appelée lorsque l’erreur MCA peut être 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éfini 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

    Routine fournie par le pilote à appeler lorsque l’exception machine check (MCE) se produit pour des erreurs non corrigées. Un pilote ne peut pas utiliser explicitement les services de noyau ou les routines de verrouillage de rotation. Le gestionnaire est limité aux mêmes contraintes qu’un pilote qui fonctionne à l’IRQL le plus élevé.

  • DpcCallback

    Routine fournie par le pilote appelée pour les erreurs corrigées qui ont provoqué une exception de vérification automatique (MCE). Cette routine doit être appelée au DISPATCH_LEVEL.

  • DeviceContext

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

Valeur retournée

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 à un moment donné.

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

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête ntddk.h (inclure Ntddk.h)