PSHED_PI_CLEAR_ERROR_STATUS fonction de rappel (ntddk.h)

2025-02-07

Un plug-in PSHED ClearErrorStatus fonction de rappel efface tous les registres d’état d’erreur spécifiques à la plateforme pour une condition d’erreur matérielle corrigée.

Syntaxe

PSHED_PI_CLEAR_ERROR_STATUS PshedPiClearErrorStatus;

NTSTATUS PshedPiClearErrorStatus(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource,
  [in]                ULONG BufferLength,
  [in]                PWHEA_ERROR_RECORD ErrorRecord
)
{...}

Paramètres

[in, out, optional] PluginContext

Pointeur vers la zone de contexte spécifiée dans le Context membre de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET lorsque le plug-in PSHED appelé PshedRegisterPlugin fonction pour s’inscrire auprès du PSHED.

[in] ErrorSource

Pointeur vers une structure WHEA_ERROR_SOURCE_DESCRIPTOR qui décrit la source d’erreur qui a signalé l’erreur matérielle.

[in] BufferLength

Taille, en octets, de la mémoire tampon pointée par le paramètre ErrorRecord.

[in] ErrorRecord

Pointeur vers une structure WHEA_ERROR_RECORD qui décrit un enregistrement d’erreur. L’enregistrement d’erreur décrit la condition d’erreur matérielle corrigée pour laquelle les registres d’état d’erreur spécifiques à la plateforme sont effacés.

Valeur de retour

Un plug-in PSHED ClearErrorStatus fonction de rappel retourne l’un des codes NTSTATUS suivants :

Retourner le code	Description
STATUS_SUCCESS	L’état d’erreur spécifique à la plateforme s’inscrit pour la condition d’erreur matérielle corrigée a été effacé.
STATUS_NOT_SUPPORTED	Le plug-in PSHED ne prend pas en charge la source d’erreur spécifiée.
STATUS_UNSUCCESSFUL	Une erreur s’est produite.

Remarques

Un plug-in PSHED qui participe à la récupération des informations d’erreur définit les Callbacks.RetrieveErrorInfo, Callbacks.FinaliseErrorRecordet Callbacks.ClearErrorStatus membres de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET pour pointer à son RetrieveErrorInfo, FinaliseErrorRecordet fonctions de rappel ClearErrorStatus lorsque le plug-in appelle la fonction PshedRegisterPlugin pour s’inscrire auprès du PSHED. Le plug-in PSHED doit également définir l’indicateur PshedFAErrorInfoRetrieval dans le membre FunctionalAreaMask de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Pour les conditions d’erreur matérielle corrigées, le noyau Windows appelle le PSHED pour effacer l’état d’erreur de la source d’erreur s’inscrit lors de la dernière étape du traitement de l’erreur. Si un plug-in PSHED est inscrit pour participer à la récupération des informations d’erreur, le plug-in PSHED appelle le plug-in PSHED ClearErrorStatus fonction de rappel afin que le plug-in PSHED puisse effacer les registres d’état d’erreur spécifiques à la plateforme supplémentaires.