PSHED_PI_SET_ERROR_SOURCE_INFO fonction de rappel (ntddk.h)

Article
02/07/2025

Un plug-in PSHED SetErrorSourceInfo fonction de rappel configure une source d’erreur.

Syntaxe

PSHED_PI_SET_ERROR_SOURCE_INFO PshedPiSetErrorSourceInfo;

NTSTATUS PshedPiSetErrorSourceInfo(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource
)
{...}

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 configurée.

Valeur de retour

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

Retourner le code	Description
STATUS_SUCCESS	La source d’erreur a été correctement configurée.
STATUS_NOT_SUPPORTED	Le plug-in PSHED ne prend pas en charge la configuration de la source d’erreur spécifiée.
STATUS_UNSUCCESSFUL	Une erreur s’est produite.

Remarques

Un plug-in PSHED qui participe au contrôle de code source d’erreur définit les Callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSourceet Callbacks.DisableErrorSource membres de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET pour pointer vers le point à son SetErrorSourceInfo, EnableErrorSourceet fonctions de rappel DisableErrorSource 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 PshedFAErrorSourceControl dans le membre FunctionalAreaMask de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Le noyau Windows appelle le PSHED pour configurer une source d’erreur en réponse à une demande de configuration de source d’erreur par une application de gestion WHEA. Si un plug-in PSHED est inscrit pour participer au contrôle de code source d’erreur, le PSHED appelle le plug-in PSHED SetErrorSourceInfo fonction de rappel pour permettre au plug-in PSHED d’effectuer l’opération de configuration de la source d’erreur. Les données de configuration de la source d’erreur sont incluses dans la structure WHEA_ERROR_SOURCE_DESCRIPTOR pointée par le paramètre errorSource .

Si le plug-in PSHED ne prend pas en charge la configuration de la source d’erreur spécifiée, la fonction de rappel SetErrorSourceInfo retourne STATUS_NOT_SUPPORTED. Dans ce cas, le PSHED effectue l’opération de configuration de source d’erreur demandée.

Si le plug-in PSHED prend en charge la configuration de la source d’erreur spécifiée, la fonction de rappel SetErrorSourceInfo doit enregistrer les données de configuration de la source d’erreur dans le Registre, dans les tables BIOS du système ou dans une autre forme de stockage de données nonvolatile disponible pour la source d’erreur. La forme spécifique du stockage de données nonvolatile utilisé par une source d’erreur pour stocker les données de configuration de la source d’erreur est spécifique à l’implémentation. La fonction de rappel SetErrorSourceInfo doit appliquer les données de configuration à la source d’erreur de telle sorte que les modifications de configuration deviennent effectives la prochaine fois que le système est redémarré. Lorsque le système est redémarré, le plug-in PSHED doit signaler les nouvelles données de configuration de la source d’erreur pour la source d’erreur au système d’exploitation lors de la découverte de la source d’erreur.