StorPortSetPowerSettingNotificationGuids-Funktion (storport.h)
Die StorPortSetPowerSettingNotificationGuids-Routine ermöglicht es einem Miniport, Energieeinstellungsbenachrichtigungen zu empfangen. Der Miniport registriert ein Array von GUIDs, die die Energieeinstellungen identifizieren, für die Energieänderungsbenachrichtigungen empfangen werden sollen.
Syntax
ULONG StorPortSetPowerSettingNotificationGuids(
[in] PVOID HwDeviceExtension,
[in] ULONG GuidCount,
[in] LPGUID Guid
);
Parameter
[in] HwDeviceExtension
Ein Zeiger auf die Hardwaregeräteerweiterung für den Host bus adapter (HBA).
[in] GuidCount
Die Anzahl der GUIDs im Guid-Array .
[in] Guid
Ein Array von POWER-Einstellungs-GUIDs, die für Benachrichtigungen registriert werden sollen. Eine typische Verwendung für die Registrierung dieser GUIDs ist, dass SATA-Miniports Benachrichtigungen über Änderungen der AHCI Link Power Management-Einstellung empfangen. Die vom Microsoft AHCI StorPort-Miniporttreiber definierten Einstellungen für die AHCI Link-Energieverwaltung sind wie folgt.
HIPM/DIPM-Einstellung (0b2d69d7-a2a1-449c-9680-f91c70521c60)
Konfiguriert den Verbindungs-Energieverwaltungsmodus für Datenträger- und Speichergeräte, die über eine AHCI-Schnittstelle an das System angeschlossen sind
| Index | Name | BESCHREIBUNG |
|---|---|---|
| 0 | Aktiv | Die Verbindungszustand-Energieverwaltung wird nicht verwendet. |
| 1 | HIPM | Host-Initiated Power Management (HIPM) wird verwendet. |
| 2 | HIPM und DIPM | HIPM und Device-Initiated Power Management (DIPM) werden verwendet. |
Adaptive Einstellung (dab60367-53fe-4fbc-825e-521d069d2456)
Die Leerlaufzeit der AHCI-Verknüpfung, bevor der Link in einen Schlummerzustand versetzt wird, wenn HIPM oder DIPM aktiviert ist.
| Wert | BESCHREIBUNG |
|---|---|
| 0 | Mindestwert in Millisekunden (nur Partieller Zustand verwenden). |
| ... | Ein beliebiger Zwischenwert. |
| 300000 | Maximaler Wert in Millisekunden (5 Minuten). |
Andere Miniports können ihre eigenen Energieeinstellungs-GUIDs definieren und registrieren.
Rückgabewert
Die StorPortSetPowerSettingNotificationGuids-Routine gibt einen der folgenden status Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Für die Registrierung für Benachrichtigungen sind unzureichende Ressourcen verfügbar. |
|
Die Benachrichtigungs-GUIDs wurden erfolgreich registriert. |
Hinweise
Ein Miniport ruft StorPortSetPowerSettingNotificationGuids in seiner HwStorFindAdapter-Routine auf, um die GUIDs zu registrieren, für die Benachrichtigungen angefordert werden sollen.
Wenn eine Energiezustandsänderung für eine registrierte Benachrichtigung auftritt, wird der Miniport in seiner HwStorAdapterControl-Routine benachrichtigt. Der Steuerelementtyp von ScsiPowerSettingNotification wird im ControlType-Parameter festgelegt.
Die AHCI Link Power-Verwaltungseinstellungen sind Teil der Untergruppe Datenträgereinstellungen (0012ee47-9041-4b5d-9b77-535fba8b1442) in der Energierichtlinienkonfiguration. Diese werden unter dem SUB_DISK-Konfigurationsalias mit powercfg.exeverwaltet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8. |
| Zielplattform | Universell |
| Header | storport.h (Storport.h einschließen) |
| IRQL | Any |