Fonction PoFxRegisterPluginEx (pepfx.h)

  • Article

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

Syntaxe

NTSTATUS PoFxRegisterPluginEx(
  [in]      PPEP_INFORMATION        PepInformation,
  [in]      ULONGLONG               Flags,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

Paramètres

[in] PepInformation

Pointeur vers une structure de PEP_INFORMATION qui contient des pointeurs vers une ou plusieurs routines de rappel implémentées par le PEP. Ces routines gèrent les notifications envoyées au PEP par PoFx.

[in] Flags

Ensemble de bits d’indicateur pour la configuration de l’interface PEP. Définissez ce membre sur zéro ou sur la valeur suivante.

Bit d’indicateur Description
PEP_FLAG_WORKER_CONCURRENCY

[in, out] KernelInformation

Pointeur vers une structure PEP_KERNEL_INFORMATION .

Valeur retournée

PoFxRegisterPluginEx 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 requises 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 mis en service, le système d’exploitation doit redémarrer.

La routine PoFxRegisterPlugin est similaire à PoFxRegisterPluginEx, sauf qu’elle ne prend pas de paramètre Flags .

Le pep doit appeler PoFxRegisterPluginEx à 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 pepfx.h (include Pep_x.h)
Bibliothèque Ntoskrnl.lib
IRQL PASSIVE_LEVEL

Voir aussi

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin