Funzione StorPortInitializePoFxPower (storport.h)

Articolo
02/27/2024

Un driver miniport chiama StorPortInitializePoFxPower per registrare un dispositivo di archiviazione con il framework di risparmio energia (PoFx).

Sintassi

ULONG StorPortInitializePoFxPower(
  [in]           PVOID             HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS     Address,
  [in]           PSTOR_POFX_DEVICE Device,
  [in, out]      PBOOLEAN          D3ColdEnabled
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).

[in, optional] Address

Indirizzo di un'unità dispositivo di archiviazione. Questo parametro è NULL durante la registrazione per una scheda di archiviazione.

[in] Device

Puntatore a una struttura STOR_POFX_DEVICE_V2 di cui viene eseguito il cast a un puntatore a STOR_POFX_DEVICE. Questa struttura contiene un elenco di componenti con stati F per un dispositivo di archiviazione.

[in, out] D3ColdEnabled

Puntatore a un valore BOOLEAN che il driver Storport imposterà per indicare se lo stato freddo D3 è abilitato per il dispositivo di archiviazione.

Valore restituito

La routine StorPortInitializePoFxPower restituisce uno dei codici di stato seguenti:

Codice restituito	Descrizione
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension o Device è NULL. -oppure- L'indirizzo punta a una struttura di indirizzi di unità non valida. -oppure- Il dispositivo di archiviazione specificato da Address non viene trovato. -oppure- La struttura STOR_POFX_DEVICE a cui punta il dispositivo è formattata in modo non corretto o contiene dati non validi.
STOR_STATUS_SUCCESS	Il dispositivo di archiviazione è stato registrato correttamente con PoFx.
STOR_STATUS_INSUFFICIENT_RESOURCES	Non sono disponibili risorse sufficienti per registrare il dispositivo di archiviazione con PoFx.
STOR_STATUS_UNSUCCESSFUL	Il dispositivo di archiviazione non è stato registrato correttamente con PoFx. -oppure- Il dispositivo di archiviazione è già registrato con PoFx.

Commenti

I dispositivi adattatori vengono sempre registrati con un valore NULL per address. I dispositivi unità vengono registrati specificando un indirizzo di unità valido per l'indirizzo.

Se il flag STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD è impostato nel membro Flags di Device, Storport tenterà di abilitare il supporto D3 Cold per il componente del dispositivo. Lo stato abilitato per L'accesso sporadico D3 viene restituito nel valore BOOLEAN a cui punta D3ColdEnabled.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.
Piattaforma di destinazione	Universale
Intestazione	storport.h

Vedi anche

STOR_POFX_DEVICE

Condividi tramite