Funzione StorPortPoFxSetComponentResidency (storport.h)

Articolo
02/07/2025

La routine StorPortPoFxSetComponentReside ncy imposta il tempo stimato per quanto tempo un componente del dispositivo di archiviazione rimane inattiva dopo che il componente entra nella condizione di inattività.

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 la scheda bus host (HBA). Questa è l'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 di STOR_POFX_DEVICE che il driver miniport registrato per il dispositivo con una chiamata a StorPortInitializePoFxPower. Se la matrice Components contiene N elementi, gli indici dei componenti sono compresi tra 0 e N-1.

[in] Residency

Tempo di residenza stimato, in unità di 100 nanosecondi. Questo parametro è un suggerimento per il framework di risparmio energia (PoFx) per quanto tempo è probabile che il componente rimanga inattiva dopo una transizione dalla condizione attiva alla condizione inattiva.

Valore restituito

La routine StorPortPoFxSetComponentReside ncy restituisce uno di questi codici di stato:

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	La residenza dei componenti viene impostata correttamente.
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- L'indice in Componente 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Universale
intestazione	storport.h
libreria	Storport.lib
IRQL	<= DISPATCH_LEVEL

Vedere anche

PoFxSetComponentResidency

Condividi tramite