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 für den Empfang von Stromänderungsbenachrichtigungen identifizieren.
Syntax
ULONG StorPortSetPowerSettingNotificationGuids(
[in] PVOID HwDeviceExtension,
[in] ULONG GuidCount,
[in] LPGUID Guid
);
Parameter
[in] HwDeviceExtension
Ein Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).
[in] GuidCount
Die Anzahl der GUIDs im guid Arrays.
[in] Guid
Ein Array von Power Setting-GUIDs, die für die Benachrichtigung registriert werden sollen. Eine typische Verwendung zum Registrieren dieser GUIDs ist für SATA-Miniports zum Empfangen von Benachrichtigungen für AHCI Link Power Management-Einstellungsänderungen. Die vom Microsoft AHCI StorPort-Miniporttreiber definierten AHCI Link Power Management-Einstellungen sind die folgenden:
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 Energieverwaltung für Verknüpfungen 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)
Der Zeitraum der AHCI-Verknüpfung im Leerlauf, bevor der Link in einen Schlummerzustand versetzt wird, wenn HIPM oder DIPM aktiviert ist.
| Wert | Beschreibung |
|---|---|
| 0 | Minimalwert in Millisekunden (nur Partieller Zustand verwenden). |
| ... | Jeder Zwischenwert. |
| 300000 | Maximalwert in Millisekunden (5 Minuten). |
Andere Miniports können eigene GuiDs für die Leistungseinstellung definieren und registrieren.
Rückgabewert
Die StorPortSetPowerSettingNotificationGuids Routine gibt einen der folgenden Statuscodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Unzureichende Ressourcen stehen zur Registrierung für Benachrichtigungen zur Verfügung. |
|
Die Benachrichtigungs-GUIDs wurden erfolgreich registriert. |
Bemerkungen
Ein Miniport ruft StorPortSetPowerSettingNotificationGuids in seiner HwStorFindAdapter Routine auf, um die GUIDs zu registrieren, für die er Benachrichtigungen empfängt.
Wenn eine Leistungsstatusänderung für eine registrierte Benachrichtigung auftritt, wird der Miniport in seiner HwStorAdapterControl- Routine benachrichtigt. Der Steuerelementtyp ScsiPowerSettingNotification wird im parameter ControlType festgelegt.
Die AHCI Link Power Management-Einstellungen 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 |
|---|---|
| mindestens unterstützte Client- | Ab Windows 8 verfügbar. |
| Zielplattform- | Universal |
| Header- | storport.h (include Storport.h) |
| IRQL- | Jegliche |