Fonction PoFxRegisterCoreDevice (pepfx.h)

  • Article

La routine PoFxRegisterCoreDevice enregistre une nouvelle ressource système principale auprès de l’infrastructure de gestion de l’alimentation Windows (PoFx).

Syntaxe

NTSTATUS PoFxRegisterCoreDevice(
  [in]  PCUNICODE_STRING   Id,
  [in]  PPO_FX_CORE_DEVICE Device,
  [out] POHANDLE           *Handle
);

Paramètres

[in] Id

Chaîne qui identifie de manière unique la ressource système principale. Ce membre est un pointeur vers une structure UNICODE_STRING qui contient une chaîne d’identification d’appareil.

[in] Device

Pointeur vers une structure PO_FX_CORE_DEVICE qui décrit les caractéristiques d’alimentation de la ressource système principale.

[out] Handle

Pointeur vers un emplacement dans lequel la routine écrit une valeur POHANDLE. Ce handle représente l’inscription de la ressource système principale auprès de PoFx.

Valeur retournée

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

Valeur retournée Description
STATUS_INVALID_PARAMETER
 Le nombre de composants de cet appareil est égal à zéro, ou la structure PO_FX_CORE_DEVICE contient un numéro de version non valide, ou le membre ComponentCriticalTransitionCallback de cette structure contient un pointeur de fonction non valide.
STATUS_INSUFFICIENT_RESOURCES
 Impossible d’allouer les ressources nécessaires pour terminer l’inscription demandée.

Remarques

Cette routine inscrit une ressource système de base afin que cette ressource puisse être gérée par PoFx.

Les ressources système principales sont des périphériques matériels, tels que les minuteurs et les contrôleurs d’interruption, qui sont gérés par la couche d’abstraction matérielle Windows (HAL). Ces appareils fournissent des fonctions de base requises par le système d’exploitation. En raison de la relation étroite entre les ressources système principales et les processeurs, la gestion de l’alimentation de ces ressources doit être coordonnée avec la gestion de l’état d’inactivité du processeur.

La routine PoFxRegisterCoreDevice doit être appelée dans 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

PO_FX_CORE_DEVICE

UNICODE_STRING