StorPortSetPowerSettingNotificationGuids, fonction (storport.h)
La routine StorPortSetPowerSettingNotificationGuids permet à un miniport de recevoir des notifications de paramètre d’alimentation. Le miniport inscrit un tableau de GUID qui identifie les paramètres d’alimentation pour lesquels recevoir des notifications de modification de l’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 de 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 apportées au paramètre AHCI Link Power Management. Les paramètres de gestion de l’alimentation de liaison 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 de liaison pour les périphériques de disque et de stockage attachés au système via une interface AHCI.
| Index | Nom | Description |
|---|---|---|
| 0 | Actif | La gestion de l’alimentation de liaison n’est pas utilisée. |
| 1 | HIPM | Host-Initiated la gestion de l’alimentation (HIPM) est utilisée. |
| 2 | HIPM et DIPM | HIPM et Device-Initiated Gestion de l’alimentation (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 de retour
La routine StorPortSetPowerSettingNotificationGuids retourne l’un des codes d’état suivants :
| Retourner le code | Description |
|---|---|
|
Les ressources insuffisantes sont disponibles pour s’inscrire aux notifications. |
|
Les GUID de notification ont été enregistrés avec succès. |
Remarques
Un miniport appelle StorPortSetPowerSettingNotificationGuids dans sa routine HwStorFindAdapter pour inscrire les GUID dont il demande la réception de notifications.
Lorsqu’une modification de l’état de l’alimentation se produit pour une notification inscrite, le miniport est averti 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 Paramètres du disque (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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| plateforme cible | Universel |
| d’en-tête | storport.h (include Storport.h) |
| IRQL | Quelconque |