PSHED_PI_CLEAR_ERROR_STATUS fonction de rappel (ntddk.h)

Article
02/26/2024

La fonction de rappel ClearErrorStatus d’un plug-in PSHED efface toute erreur spécifique à la plateforme status s’inscrit 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 membre Context de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET lorsque le plug-in PSHED a appelé la fonction PshedRegisterPlugin 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 vers le paramètre ErrorRecord .

[in] ErrorRecord

Pointeur vers une structure de 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’erreur spécifiques à la plateforme status sont effacés.

Valeur retournée

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

Code de retour	Description
STATUS_SUCCESS	L’erreur spécifique à la plateforme status les enregistrements pour la condition d’erreur matérielle corrigée ont été effacés.
STATUS_NOT_SUPPORTED	Le plug-in PSHED ne prend pas en charge la source d’erreur spécifiée.
STATUS_UNSUCCESSFUL	Une erreur est survenue.

Remarques

Un plug-in PSHED qui participe à la récupération des informations d’erreur définit les membres Callbacks.RetrieveErrorInfo, Callbacks.FinaliseErrorRecord et Callbacks.ClearErrorStatus de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET pour pointer vers ses fonctions de rappel RetrieveErrorInfo, FinaliseErrorRecord et 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’erreur de la source d’erreur status s’inscrit comme étape finale du traitement de l’erreur. Si un plug-in PSHED est inscrit pour participer à la récupération des informations d’erreur, le PSHED appelle la fonction de rappel ClearErrorStatus du plug-in PSHED afin que le plug-in PSHED puisse effacer toute erreur supplémentaire spécifique à la plateforme status registres.