Funzione StorPortSetPowerSettingNotificationGuids (storport.h)

  • Articolo

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
STOR_STATUS_INSUFFICIENT_RESOURCES
 Sono disponibili risorse insufficienti per la registrazione per le notifiche.
STOR_STATUS_SUCCESS
 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

Vedi anche

HwStorAdapterControl

HwStorFindAdapter