PSHED_PI_GET_ERROR_SOURCE_INFO fonction de rappel (ntddk.h)

Article
04/21/2023

La fonction de rappel GetErrorSourceInfo d’un plug-in PSHED retourne une structure de descripteur source d’erreur qui représente une source d’erreur particulière implémentée par la plateforme matérielle.

Syntaxe

PSHED_PI_GET_ERROR_SOURCE_INFO PshedPiGetErrorSourceInfo;

NTSTATUS PshedPiGetErrorSourceInfo(
  [in, out, optional] PVOID PluginContext,
  [in, out]           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, out] ErrorSource

Pointeur vers une structure WHEA_ERROR_SOURCE_DESCRIPTOR qui représente une source d’erreur particulière implémentée par la plateforme matérielle.

Valeur retournée

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

Code de retour	Description
STATUS_SUCCESS	Les informations sur la source d’erreur ont été correctement mises à jour.
STATUS_UNSUCCESSFUL	Une erreur est survenue.

Remarques

Un plug-in PSHED qui participe à la découverte de source d’erreur définit le membre Callbacks.GetAllErrorSources et, éventuellement, le membre Callbacks.GetErrorSourceInfo de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET pour pointer vers ses fonctions de rappel GetAllErrorSources et GetErrorSourceInfo 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 PshedFADiscovery dans le membre FunctionalAreaMask de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET .

Le noyau Windows appelle le PSHED pour obtenir des détails supplémentaires sur une source d’erreur particulière. Cela se produit lorsqu’une nouvelle source d’erreur est ajoutée au système par un pilote de bus. Par exemple, lorsque le pilote PCI découvre un périphérique PCI Express (PCIe) capable de signaler des erreurs PCIe, il signale la source d’erreur au système d’exploitation.

Si un plug-in PSHED est inscrit pour participer à la découverte de source d’erreur et qu’il a implémenté une fonction de rappel GetErrorSourceInfo , une fois que le PSHED a mis à jour la structure de descripteur source d’erreur avec les informations qu’il a collectées sur la source d’erreur, le PSHED appelle la fonction de rappel GetErrorSourceInfo du plug-in PSHED afin que le plug-in PSHED puisse fournir des détails supplémentaires sur la source d’erreur. La fonction de rappel GetErrorSourceInfo met à jour le contenu de la structure de descripteur source d’erreur afin qu’elle représente avec précision la source d’erreur telle qu’elle est implémentée par la plateforme matérielle.