Fonction StorPortSetPowerSettingNotificationGuids (storport.h)

Article
02/29/2024

La routine StorPortSetPowerSettingNotificationGuids permet à un miniport de recevoir des notifications de paramètre d’alimentation. Le miniport enregistre un tableau de GUID qui identifient les paramètres d’alimentation pour lesquels recevoir des notifications de changement d’alimentation.

Syntaxe

ULONG StorPortSetPowerSettingNotificationGuids(
  [in] PVOID  HwDeviceExtension,
  [in] ULONG  GuidCount,
  [in] LPGUID Guid
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

[in] GuidCount

Nombre d’GUID dans le tableau Guid .

[in] Guid

Tableau de GUID de paramètre d’alimentation à inscrire pour la notification. Une utilisation classique pour l’inscription de ces GUID est que les miniports SATA reçoivent des notifications pour les modifications des paramètres de gestion de l’alimentation des liens AHCI. Les paramètres de gestion de l’alimentation des liens AHCI définis par le pilote miniport Microsoft AHCI StorPort sont les suivants.

Paramètre HIPM/DIPM (0b2d69d7-a2a1-449c-9680-f91c70521c60)

Configure le mode de gestion de l’alimentation des liens pour les disques et les périphériques de stockage attachés au système via une interface AHCI.

Index	Nom	Description
0	Actif	La gestion de l’alimentation des liens n’est pas utilisée.
1	HIPM	Host-Initiated Gestion de l’alimentation (HIPM) est utilisée.
2	HIPM et DIPM	HIPM et Device-Initiated Power Management (DIPM) sont utilisés.

Paramètre adaptatif (dab60367-53fe-4fbc-825e-521d069d2456)

Période d’inactivité du lien AHCI avant que le lien ne soit mis dans un état d’inactivité lorsque HIPM ou DIPM est activé.

Valeur	Description
0	Valeur minimale en millisecondes (utilisez uniquement l’état Partiel).
...	Toute valeur intermédiaire.
300000	Valeur maximale en millisecondes (5 minutes).

D’autres miniports peuvent définir et inscrire leurs propres GUID de paramètre d’alimentation.

Valeur retournée

La routine StorPortSetPowerSettingNotificationGuids retourne l’un des codes status suivants :

Code de retour	Description
STOR_STATUS_INSUFFICIENT_RESOURCES	Les ressources disponibles sont insuffisantes pour s’inscrire aux notifications.
STOR_STATUS_SUCCESS	Les GUID de notification ont été inscrits avec succès.

Remarques

Un miniport appelle StorPortSetPowerSettingNotificationGuids dans sa routine HwStorFindAdapter pour inscrire les GUID qu’il demande de recevoir des notifications.

Lorsqu’un changement d’état d’alimentation se produit pour une notification inscrite, le miniport est notifié dans sa routine HwStorAdapterControl . Le type de contrôle de ScsiPowerSettingNotification est défini dans le paramètre ControlType .

Les paramètres de gestion de l’alimentation du lien AHCI font partie du sous-groupe Disk Settings (0012ee47-9041-4b5d-9b77-535fba8b1442) dans la configuration de la stratégie d’alimentation. Ils sont gérés sous l’alias de configuration SUB_DISK avec powercfg.exe.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Universal
En-tête	storport.h (inclure Storport.h)
IRQL	Quelconque

Voir aussi

HwStorAdapterControl

HwStorFindAdapter

Partager via