Funzione StorPortInitializePoFxPower (storport.h)

Articolo
02/07/2025

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 la scheda 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 eseguire 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 imposta per indicare se lo stato D3 Cold è abilitato per il dispositivo di archiviazione.

Valore restituito

La routine StorPortInitializePoFxPower restituisce uno di questi codici di stato:

Codice restituito	Descrizione
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension o Device è NULL. -o- Address punta a una struttura di indirizzi di unità non valida. -o- Il dispositivo di archiviazione specificato da Address non viene trovato. -o- La struttura STOR_POFX_DEVICE a cui punta 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	Risorse sufficienti non sono disponibili per registrare il dispositivo di archiviazione con PoFx.
STOR_STATUS_UNSUCCESSFUL	Il dispositivo di archiviazione non è stato registrato correttamente con PoFx. -o- Il dispositivo di archiviazione è già registrato con PoFx.

Osservazioni

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

Se il flag STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD è impostato nel flag membro 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 booleano booleano a cui punta D3ColdEnabled.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Universale
intestazione	storport.h

Vedere anche

STOR_POFX_DEVICE

Condividi tramite