Funzione StorPortSetPowerSettingNotificationGuids (storport.h)
La routine StorPortSetPowerSettingNotificationGuids consente a un miniport di ricevere notifiche di impostazione alimentazione. Il miniport registra una matrice di GUID che identificano le impostazioni di risparmio energia per ricevere notifiche di modifica alimentazione.
Sintassi
ULONG StorPortSetPowerSettingNotificationGuids(
[in] PVOID HwDeviceExtension,
[in] ULONG GuidCount,
[in] LPGUID Guid
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).
[in] GuidCount
Numero di GUID nella matrice Guid .
[in] Guid
Matrice di GUID per l'impostazione dell'alimentazione da registrare per la notifica. Un uso tipico per la registrazione di questi GUID è per i miniport SATA per ricevere notifiche per le modifiche delle impostazioni di risparmio energia collegamento AHCI. Di seguito sono riportate le impostazioni di gestione alimentazione collegamento AHCI definite dal driver miniport StorPort Microsoft AHCI.
Impostazione HIPM/DIPM (0b2d69d7-a2a1-449c-9680-f91c70521c60)
Configura la modalità di risparmio energia del collegamento per i dispositivi di archiviazione e disco collegati al sistema tramite un'interfaccia AHCI.
| Indice | Nome | Descrizione |
|---|---|---|
| 0 | Attivo | Il risparmio energia del collegamento non viene usato. |
| 1 | HIPM | Host-Initiated viene usato Il risparmio energia (HIPM). |
| 2 | HIPM e DIPM | Vengono usati HIPM e Device-Initiated Risparmio energia (DIPM). |
Impostazione adattiva (dab60367-53fe-4fbc-825e-521d069d2456)
Periodo di inattività del collegamento AHCI prima che il collegamento venga inserito in uno stato di inattività quando HIPM o DIPM è abilitato.
| Valore | Descrizione |
|---|---|
| 0 | Valore minimo in millisecondi (usare solo lo stato Parziale). |
| ... | Qualsiasi valore intermedio. |
| 300000 | Valore massimo in millisecondi (5 minuti). |
Altri miniport possono definire e registrare i PROPRI GUID delle impostazioni di risparmio energia.
Valore restituito
La routine StorPortSetPowerSettingNotificationGuids restituisce uno dei codici di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Sono disponibili risorse insufficienti per la registrazione per le notifiche. |
|
I GUID di notifica sono stati registrati correttamente. |
Commenti
Un miniport chiama StorPortSetPowerSettingNotificationGuids nella routine HwStorFindAdapter per registrare i GUID per cui richiede di ricevere notifiche.
Quando si verifica una modifica dello stato di alimentazione per una notifica registrata, il miniport riceve una notifica nella routine HwStorAdapterControl . Il tipo di controllo ScsiPowerSettingNotification viene impostato nel parametro ControlType .
Le impostazioni di risparmio energia collegamento AHCI fanno parte del sottogruppo Impostazioni disco (0012ee47-9041-4b5d-9b77-535fba8b1442) nella configurazione dei criteri di alimentazione. Questi vengono gestiti con l'alias di configurazione SUB_DISK con powercfg.exe.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 8. |
| Piattaforma di destinazione | Universale |
| Intestazione | storport.h (include Storport.h) |
| IRQL | Qualsiasi |