WheaAddErrorSourceDeviceDriver, fonction (ntddk.h)

Article
02/07/2025

Un pilote de périphérique appelle WheaAddErrorSourceDeviceDriver pour ajouter une source d’erreur.

Syntaxe

NTSTATUS WheaAddErrorSourceDeviceDriver(
  PVOID                                          Context,
  PWHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER Configuration,
  ULONG                                          NumberPreallocatedErrorReports
);

Paramètres

Context

Pointeur facultatif vers un contexte alloué par l’appelant. WHEA fournit le contexte en tant que paramètre pour les routines de rappel fournies par le pilote. Peut être NULL.

Configuration

Pointeur vers une structure de type WHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER qui contient un ensemble de routines de rappel fournies par le pilote.

NumberPreallocatedErrorReports

Valeur de type ULONG qui spécifie le nombre d’enregistrements à préallouer. Pour plus d’informations, consultez les remarques.

Valeur de retour

Cette méthode de fonction retourne STATUS_SUCCESS si la source d’erreur est ajoutée. Sinon, il peut retourner l’une des options suivantes :

STATUS_INVALID_PARAMETER : la configuration est manquante pour initialiser et/ou annuler l’initialisation des pointeurs de rappel.
STATUS_INVALID_PARAMETER_2 : une configuration avec une version non valide a été envoyée.
STATUS_INSUFFICIENT_RESOURCES : WHEA n’a pas pu allouer d’espace pour la source d’erreur et ses enregistrements.

Remarques

Pour supprimer une source d’erreur, le pilote appelle WheaRemoveErrorSourceDeviceDriver.

WHEA peut préallouer la mémoire pour les erreurs qui seront signalées au niveau élevé d’IRQL (c’est-à-dire dans le contexte d’une interruption d’appareil). Pour les sources d’erreur signalées à PASSIVE_LEVEL, la préallocation n’est pas nécessaire, mais si le pilote de périphérique signale des erreurs pour sa source d’erreur à DISPATCH_LEVEL ou une version ultérieure, les enregistrements d’erreurs doivent être préalloués.

Pour plus d’informations, consultez Using WHEA on Windows 10.