PSHED_PI_GET_INJECTION_CAPABILITIES fonction de rappel (ntddk.h)

Article
02/07/2025

Un plug-in PSHED GetInjectionCapabilities fonction de rappel retourne une union de fonctionnalités d’injection d’erreurs qui décrit les types d’erreurs matérielles qui peuvent être injectées dans la plateforme matérielle.

Syntaxe

PSHED_PI_GET_INJECTION_CAPABILITIES PshedPiGetInjectionCapabilities;

NTSTATUS PshedPiGetInjectionCapabilities(
  [in, out, optional] PVOID PluginContext,
  [out]               PWHEA_ERROR_INJECTION_CAPABILITIES Capabilities
)
{...}

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.

[out] Capabilities

Pointeur vers une union WHEA_ERROR_INJECTION_CAPABILITIES. Cette union reçoit les données qui décrivent les types d’erreurs matérielles qui peuvent être injectées dans la plateforme matérielle.

Valeur de retour

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

Retourner le code	Description
STATUS_SUCCESS	Les données qui décrivent les types d’erreurs matérielles qui peuvent être injectées dans la plateforme matérielle ont été correctement retournées dans l’union WHEA_ERROR_INJECTION_CAPABILITIES pointée par le paramètre Capabilities.
STATUS_UNSUCCESSFUL	Une erreur s’est produite.

Remarques

Un plug-in PSHED qui participe à l’injection d’erreurs définit les membres Callbacks.GetInjectionCapabilities et Callbacks.InjectError membres de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET à pointer vers son GetInjectionCapabilities et fonctions de rappel InjectError 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 PshedFAErrorInjection dans le membre FunctionalAreaMask de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Le noyau Windows appelle le PSHED pour récupérer des informations sur les types d’erreurs matérielles qui peuvent être injectées dans la plateforme matérielle en réponse à une enquête sur les fonctionnalités d’injection d’erreurs par une application de gestion WHEA. Si un plug-in PSHED est inscrit pour participer à l’injection d’erreurs, le PSHED appelle le plug-in PSHED GetInjectionCapabilities fonction de rappel pour récupérer des informations sur des types supplémentaires d’erreurs matérielles qui peuvent être injectées dans la plateforme matérielle.