Funzione StorPortPoFxSetComponentResidency (storport.h)

Articolo
03/05/2024

La routine StorPortPoFxSetComponentResidency imposta il tempo stimato per quanto tempo è probabile che un componente dispositivo di archiviazione rimanga inattiva dopo che il componente entra nella condizione inattiva.

Sintassi

ULONG StorPortPoFxSetComponentResidency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Residency
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore del bus host (HBA). Si tratta dell'estensione del dispositivo usata per registrare il dispositivo in una chiamata precedente a StorPortInitializePoFxPower.

[in, optional] Address

Indirizzo di un'unità dispositivo di archiviazione. Questo parametro è NULL quando si imposta la residenza di un componente dell'adattatore di archiviazione.

[in] Component

Indice che identifica il componente. Questo parametro è un indice nella matrice Components nella struttura STOR_POFX_DEVICE che il driver miniport registrato per il dispositivo con una chiamata a StorPortInitializePoFxPower. Se la matrice Components contiene elementi N, gli indici dei componenti sono compresi tra 0 e N-1.

[in] Residency

Tempo di residenza stimato, in 100-nanosecondi. Questo parametro è un hint per il framework di risparmio energia (PoFx) per quanto tempo il componente rimane inattiva dopo una transizione dalla condizione attiva alla condizione inattiva.

Valore restituito

La routine StorPortPoFxSetComponentResidency restituisce uno di questi codici di stato:

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	La residenza del componente è impostata correttamente.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension o Device è NULL. -oppure- Gli indirizzi puntano a una struttura di indirizzi di unità non valida. -oppure- Il dispositivo di archiviazione specificato da Address non viene trovato. -oppure- L'indice in Component specifica un componente maggiore del numero di componenti per il dispositivo.
STOR_STATUS_INVALID_DEVICE_REQUEST	Il dispositivo di archiviazione non è registrato con PoFx.
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL corrente.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.
Piattaforma di destinazione	Universale
Intestazione	Storport.h
Libreria	Storport.lib
IRQL	<= DISPATCH_LEVEL

Vedi anche

PoFxSetComponentResidency

Condividi tramite