PSHED_PI_SET_ERROR_SOURCE_INFO fonction de rappel (ntddk.h)

Article
04/21/2023

La fonction de rappel SetErrorSourceInfo d’un plug-in PSHED 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 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 de WHEA_ERROR_SOURCE_DESCRIPTOR qui décrit la source d’erreur en cours de configuration.

Valeur retournée

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

Code de retour	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 est survenue.

Remarques

Un plug-in PSHED qui participe au contrôle de code source d’erreur définit les membres Callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSource et Callbacks.DisableErrorSource de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET pour pointer vers ses fonctions de rappel SetErrorSourceInfo, EnableErrorSource et 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 la fonction de rappel SetErrorSourceInfo du plug-in PSHED 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 la 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 non volatiles disponible pour la source d’erreur. La forme spécifique de stockage de données non volatiles utilisée 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 entrent en vigueur à 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.