Funzione StorPortPoFxSetComponentLatency (storport.h)

  • Articolo

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