Funzione StorPortPoFxSetComponentLatency (storport.h)

Articolo
08/07/2023

La routine StorPortPoFxSetComponentLatency specifica la latenza massima che può essere tollerata nella transizione dalla condizione di inattività alla condizione attiva nel componente del dispositivo di archiviazione specificato.

Sintassi

ULONG StorPortPoFxSetComponentLatency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Latency
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore 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 latenza 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 registrata dal driver miniport 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] Latency

Il tempo, espresso in unità di 100 nanosecondi, che il componente del dispositivo di archiviazione può tollerare per una transizione da uno stato di inattività allo stato attivo.

Valore restituito

La routine StorPortPoFxSetComponentLatency restituisce uno dei codici di stato seguenti:

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	La latenza del componente è stata impostata correttamente.
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- 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 il framework di risparmio energia (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
IRQL	<= DISPATCH_LEVEL

Vedi anche

PoFxSetComponentLatency

Condividi tramite