Fonction StorPortPoFxSetPerfState (storport.h)

Article
02/26/2024

StorPortPoFxSetPerfState définit l’état P d’un composant (état performances ou « perf »).

Syntaxe

ULONG StorPortPoFxSetPerfState(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS Address,
  ULONG         Component,
  ULONG         Flags,
  ULONG         SetIndex,
  ULONG         State,
  PVOID         Context
);

Paramètres

HwDeviceExtension

Pointeur vers l’extension d’appareil du miniport.

Address

Adresse de l’appareil en cours d’inscription. Actuellement, seules les cartes sont prises en charge. L’adresse doit donc avoir la valeur NULL.

Component

Index qui identifie le composant dont les états P seront gérés. Ce paramètre est un index dans le tableau Composantsde la structure STOR_POFX_DEVICE que le miniport a utilisé pour inscrire l’appareil pour la prise en charge de Storport PoFx. Si le tableau Composants contient N éléments, les index des composants vont de 0 à N–1.

Flags

Actuellement, doit être défini sur NULL.

SetIndex

Index d’un jeu de performances précédemment inscrit.

State

Si le jeu de performances contient des états P discrets, il doit s’agir d’une valeur d’index. Si le jeu de performances est une plage, il doit s’agir d’une valeur dans cette plage.

Context

Contexte arbitraire qui sera passé au rappel de modification du paramètre perf.

Valeur retournée

StorPortPoFxSetPerfState retourne STOR_STATUS_SUCCESS en cas de réussite de l’exécution ou si l’alimentation du runtime a été désactivée, ou un code d’erreur tel que l’un des éléments suivants :

Code d'erreur	Signification
STOR_STATUS_INVALID_PARAMETER	L’un des paramètres n’est pas valide ; par exemple, l’adresse ou les indicateurs ne sont pas NULL.
STOR_STATUS_UNSUCCESSFUL	L’adaptateur n’est pas inscrit pour la détection d’inactivité.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
En-tête	storport.h