PSHED_PI_WRITE_ERROR_RECORD fonction de rappel (ntddk.h)

Article
02/07/2025

Un plug-in PSHED WriteErrorRecord fonction de rappel écrit un enregistrement d’erreur dans le stockage de données persistant du système.

Syntaxe

PSHED_PI_WRITE_ERROR_RECORD PshedPiWriteErrorRecord;

NTSTATUS PshedPiWriteErrorRecord(
  [in, out, optional] PVOID PluginContext,
  [in]                ULONG Flags,
  [in]                ULONG RecordLength,
  [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] Flags

Combinaison d’indicateurs or’ed bit qui affectent l’opération d’écriture. Un indicateur possible est :

WHEA_WRITE_FLAG_DUMMY

L’opération d’écriture est une opération d’écriture factice. Aucune donnée n’est écrite dans le stockage de données persistant du système.

[in] RecordLength

Taille, en octets, de l’enregistrement d’erreur pointé par le paramètre ErrorRecord.

[in] ErrorRecord

Pointeur vers une structure WHEA_ERROR_RECORD qui décrit l’enregistrement d’erreur écrit dans le stockage de données persistant du système.

Valeur de retour

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

Retourner le code	Description
STATUS_SUCCESS	L’enregistrement d’erreur a été correctement écrit dans le stockage des données persistantes du système.
STATUS_UNSUCCESSFUL	Une erreur s’est produite.

Remarques

Un plug-in PSHED qui participe à la persistance des enregistrements d’erreur définit les Callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord et Callbacks.ClearErrorRecord membres de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET à pointer vers son WriteErrorRecord, ReadErrorRecordet fonctions de rappel ClearErrorRecord 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 PshedFAErrorRecordPersistence dans l’indicateur FunctionalAreaMask de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Le noyau Windows appelle le PSHED pour écrire un enregistrement d’erreur dans le stockage de données persistants du système chaque fois qu’une condition d’erreur irrécupérable ou irrécupérable existe afin que l’enregistrement d’erreur soit conservé pendant le redémarrage du système. Si un plug-in PSHED est inscrit pour participer à la persistance des enregistrements d’erreur, le PSHED appelle le plug-in PSHED WriteErrorRecord fonction de rappel pour effectuer l’opération d’écriture. Le mécanisme utilisé pour écrire l’enregistrement d’erreur dans le stockage de données persistants du système est spécifique à la plateforme.