PshedRegisterPlugin, fonction (ntddk.h)

  • Article

La fonction PshedRegisterPlugin enregistre un plug-in PSHED avec le PSHED.

Syntaxe

NTPSHEDAPI NTSTATUS PshedRegisterPlugin(
  [in, out] PWHEA_PSHED_PLUGIN_REGISTRATION_PACKET Packet
);

Paramètres

[in, out] Packet

Pointeur vers une structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET initialisée qui décrit les informations d’inscription du plug-in PSHED.

Valeur retournée

PshedRegisterPlugin retourne l’un des codes NTSTATUS suivants :

Code de retour Description
STATUS_SUCCESS
 Le plug-in PSHED a été correctement inscrit.
STATUS_INVALID_PARAMETER
 Les données du paquet d’inscription fourni ne sont pas valides.

Remarques

Un plug-in PSHED appelle la fonction PshedRegisterPlugin pour s’inscrire auprès du PSHED. Un plug-in PSHED appelle généralement cette fonction à partir de sa fonction DriverEntry ou de sa fonction AddDevice .

À compter de Windows 10, version 1903 (WDK 10 version 18362), une V2 des interfaces PSHED-Plugin est disponible qui permet de supprimer et de mettre à jour un plug-in sur un système en cours d’exécution en appelant la fonction PshedUnregisterPlugin. Étant donné qu’ils peuvent être désinscrits, les plug-ins V2 ne peuvent pas spécifier l’indicateur PshedFADiscovery (zone fonctionnelle de découverte) dans le membre FunctionalAreaMask de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2. Pour plus d’informations sur l’inscription d’un plug-in, consultez Inscription d’un plug-in PSHED. Pour un plug-in V1, si vous essayez de vous désinscrire, une vérification de bogue peut se produire. Il est recommandé d’utiliser un plug-in V2 si possible, qui est la valeur par défaut actuelle.

Pour inscrire un plug-in V1 et un plug-in V2, utilisez le struct correct. WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V1 pour V1 et WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 pour V2.

Un plug-in V2 peut toujours ajouter des sources d’erreur comme décrit dans Utilisation de WHEA sur Windows 10, ou en appelant WheaAddErrorSource et WheaRemoveErrorSource.

Un plug-in peut continuer à utiliser la zone fonctionnelle de découverte en spécifiant WHEA_PLUGIN_REGISTRATION_PACKET_V1 comme version de sa structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 .

Tous les rappels, sur les plug-ins V1 et V2, sont appelés au minimum IRQL de DISPATCH_LEVEL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans Windows Server 2008, Windows Vista SP1 et les versions ultérieures de Windows.
Plateforme cible Universal
En-tête ntddk.h (inclure Ntddk.h)
Bibliothèque Pshed.lib
DLL Pshed.dll
IRQL <=DISPATCH_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm)

Voir aussi

AddDevice

DriverEntry

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET