Fonction PoFxQueryCurrentComponentPerfState (wdm.h)

Article
02/27/2024

La routine PoFxQueryCurrentComponentPerfState récupère l’état des performances actives dans l’ensemble d’états de performances d’un composant.

Syntaxe

NTSTATUS PoFxQueryCurrentComponentPerfState(
  [in] POHANDLE   Handle,
  [in] ULONG      Flags,
  [in] ULONG      Component,
  [in] ULONG      SetIndex,
  [in] PULONGLONG CurrentPerf
);

Paramètres

[in] Handle

Handle qui représente l’inscription de l’appareil auprès de l’infrastructure de gestion de l’alimentation (PoFx). Le pilote de périphérique a déjà reçu ce handle de la routine PoFxRegisterDevice .

[in] Flags

Définit la valeur 0. Actuellement, aucun indicateur n’est défini pour cette routine.

[in] Component

Index qui identifie le composant dont l’état de performances est récupéré. Ce paramètre est un index dans le tableau Components de la structure PO_FX_DEVICE que le pilote de périphérique a utilisé pour inscrire l’appareil auprès de PoFx. Si le tableau Composants contient N éléments, les index des composants vont de 0 à N–1.

[in] SetIndex

Index qui identifie l’ensemble d’états de performances dont les performances sont interrogées. Ce paramètre est un index dans le tableau PerfStateSets de la structure PO_FX_COMPONENT_PERF_INFO que le pilote de périphérique a utilisée pour inscrire les états de performances des composants avec PoFx. Si le tableau PerfStateSets contient N éléments, les index du jeu d’état des performances vont de 0 à N–1.

[in] CurrentPerf

Pointeur vers la variable dans laquelle l’état des performances actuel du jeu d’états de performances spécifié est retourné. Pour plus d’informations sur la valeur retournée, consultez Remarques.

Valeur retournée

PoFxQueryCurrentComponentPerfState retourne STATUS_SUCCESS si l’opération demandée réussit. Les valeurs de retour d’erreur possibles incluent les codes status suivants.

Code de retour	Description
STATUS_INVALID_PARAMETER	L’appelant a fourni un index non valide pour le jeu d’état du composant ou du composant.

Remarques

Un pilote peut appeler la routine PoFxQueryCurrentComponentPerfState pour récupérer l’état actuel des performances d’un jeu d’état de performances donné pour un composant. Si l’appel réussit, le paramètre CurrentPerf est remplacé par un pointeur vers une valeur qui spécifie l’état actuel des performances de l’ensemble. Cette valeur peut être l’une des suivantes, en fonction du contenu de la structure PO_FX_COMPONENT_PERF_SET que le pilote a passée à la routine PoFxRegisterComponentPerfStates :

Pour un jeu d’états de performances qui représente une distribution continue des états de performances, il s’agit d’une valeur entre les membres Minimum et Maximum de la structure PO_FX_COMPONENT_PERF_SET .
Pour un jeu d’états de performances qui représente un nombre discret d’états de performances, cette valeur est un index dans le membre States de la structure PO_FX_COMPONENT_PERF_SET .

Cet appel s’exécute toujours de manière synchrone.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 10.
Plateforme cible	Universal
En-tête	wdm.h
Bibliothèque	Ntoskrnl.lib
DLL	Ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL

Voir aussi

Gestion de l’état des performances des appareils

PO_FX_COMPONENT_PERF_INFO

PO_FX_COMPONENT_PERF_SET

PoFxRegisterComponentPerfStates

Partager via