Fonction PoFxRegisterPlugin (pep_x.h)

  • Article

La routine PoFxRegisterPlugin enregistre un plug-in d’extension de plateforme (PEP) auprès de l’infrastructure de gestion de l’alimentation Windows (PoFx).

Syntaxe

NTSTATUS PoFxRegisterPlugin(
  [in]      PPEP_INFORMATION        PepInformation,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

Paramètres

[in] PepInformation

Pointeur vers une structure PEP_INFORMATION .

[in, out] KernelInformation

Pointeur vers une structure PEP_KERNEL_INFORMATION_STRUCT_V3 .

Valeur retournée

PoFxRegisterPlugin retourne STATUS_SUCCESS si l’appel inscrit correctement le PEP. Les valeurs de retour d’erreur possibles incluent les codes status suivants.

Valeur retournée Description
STATUS_INVALID_PARAMETER
 Le membre Version ou Size de la structure PEP_KERNEL_INFORMATION est défini sur une valeur non valide ; ou le membre AcceptDeviceNotification de cette structure a la valeur NULL.
STATUS_INVALID_PEP_INFO_VERSION
 Le membre Version de la structure PEP_INFORMATION est défini sur une valeur non valide.
STATUS_INSUFFICIENT_RESOURCES
 Impossible d’allouer les ressources nécessaires pour terminer l’inscription demandée.

Remarques

Un PEP appelle cette routine pour s’inscrire auprès de PoFx.

Un PEP ne peut pas annuler l’inscription et ne peut pas s’inscrire deux fois. Si le PEP doit être remis en service, le système d’exploitation doit redémarrer.

La routine PoFxRegisterPluginEx est similaire à PoFxRegisterPlugin, sauf qu’elle prend un paramètre supplémentaire, Flags.

Le PEP doit appeler PoFxRegisterPlugin à l’adresse IRQL = PASSIVE_LEVEL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 10.
Plateforme cible Windows
En-tête pep_x.h (include Pep_x.h)
Bibliothèque Ntoskrnl.lib
IRQL PASSIVE_LEVEL

Voir aussi

PEP_INFORMATION

PEP_KERNEL_INFORMATION_STRUCT_V3

PoFxRegisterPluginEx