PSHED_PI_GET_ERROR_SOURCE_INFO fonction de rappel (ntddk.h)

Article
02/07/2025

Un plug-in PSHED GetErrorSourceInfo fonction de rappel 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 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, 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 de retour

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

Retourner le code	Description
STATUS_SUCCESS	Les informations sur la source d’erreur ont été correctement mises à jour.
STATUS_UNSUCCESSFUL	Une erreur s’est produite.

Remarques

Un plug-in PSHED qui participe à la découverte de sources d’erreur définit le membre Callbacks.GetAllErrorSources membre et, éventuellement, le membre Callbacks.GetErrorSourceInfo de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET pour pointer vers son GetAllErrorSources et fonctions de rappel 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 appareil 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 du descripteur source d’erreur avec les informations qu’il a collectées sur la source d’erreur, le PSHED appelle le plug-in PSHED GetErrorSourceInfo fonction de rappel 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 du 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.