PSHED_PI_DISABLE_ERROR_SOURCE fonction de rappel (ntddk.h)

Article
04/21/2023

La fonction de rappel DisableErrorSource d’un plug-in PSHED désactive une source d’erreur.

Syntaxe

PSHED_PI_DISABLE_ERROR_SOURCE PshedPiDisableErrorSource;

NTSTATUS PshedPiDisableErrorSource(
  [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 désactivation.

Valeur retournée

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

Code de retour	Description
STATUS_SUCCESS	La source d’erreur a été désactivée.
STATUS_NOT_SUPPORTED	Le plug-in PSHED ne prend pas en charge la désactivation 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 désactiver une source d’erreur en réponse à une demande de désactivation 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 DisableErrorSource du plug-in PSHED pour permettre au plug-in PSHED de désactiver la source d’erreur. Si la fonction de rappel DisableErrorSource retourne STATUS_NOT_SUPPORTED, le PSHED désactive la source d’erreur. Sinon, le PSHED retourne simplement la valeur de retour retournée par la fonction de rappel DisableErrorSource .

Si le plug-in PSHED désactive correctement la source d’erreur, le PSHED met à jour la structure WHEA_ERROR_SOURCE_DESCRIPTOR pour le compte du plug-in PSHED après le retour de l’appel à la fonction de rappel DisableErrorSource du plug-in PSHED. La fonction de rappel DisableErrorSource d’un plug-in PSHED ne doit pas modifier le descripteur source d’erreur.