Funzione StorPortInitializePoFxPower (storport.h)

  • Articolo

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