PSHED_PI_ENABLE_ERROR_SOURCE fonction de rappel (ntddk.h)

Article
02/07/2025

Un plug-in PSHED EnableErrorSource fonction de rappel active une source d’erreur.

Syntaxe

PSHED_PI_ENABLE_ERROR_SOURCE PshedPiEnableErrorSource;

NTSTATUS PshedPiEnableErrorSource(
  [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 activée.

Valeur de retour

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

Retourner le code	Description
STATUS_SUCCESS	La source d’erreur a été activée avec succès.
STATUS_NOT_SUPPORTED	Le plug-in PSHED ne prend pas en charge l’activation 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 activer chacune des sources d’erreur signalées lors de la découverte de la source d’erreur. Le noyau Windows appelle également le PSHED pour activer une source d’erreur en réponse à une demande d’activation de la 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 EnableErrorSource fonction de rappel pour permettre au plug-in PSHED d’activer la source d’erreur. Si la fonction de rappel EnableErrorSource retourne STATUS_NOT_SUPPORTED, le PSHED active la source d’erreur. Sinon, le PSHED retourne simplement la valeur de retour retournée par la fonction de rappel EnableErrorSource.

Si le plug-in PSHED active correctement la source d’erreur, le PSHED met à jour la structure WHEA_ERROR_SOURCE_DESCRIPTOR pour le compte du plug-in PSHED après l’appel au plug-in PSHED EnableErrorSource fonction de rappel retourne. Un plug-in PSHED EnableErrorSource fonction de rappel ne doit pas modifier le descripteur source d’erreur.