Partager via

Fonction PoFxRegisterPluginEx (pepfx.h)

La routine PoFxRegisterPluginEx inscrit un plug-in d’extension de plateforme auprès du framework 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 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 de retour

PoFxRegisterPluginEx retourne STATUS_SUCCESS si l’appel inscrit correctement le pep. Les valeurs de retour d’erreur possibles incluent les codes d’état suivants.

Valeur de retour 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 servicené, 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 à IRQL = PASSIVE_LEVEL.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows 10.
plateforme cible Windows
d’en-tête pepfx.h (include Pep_x.h)
bibliothèque Ntoskrnl.lib
IRQL PASSIVE_LEVEL

Voir aussi

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin

  • Last updated on