Condividi tramite


Funzione StorPortPoFxSetIdleTimeout (storport.h)

Un miniport può chiamare StorPortPoFxSetIdleTimeout per impostare il valore di timeout di inattività per un adattatore, ovvero la quantità di tempo in cui un adattatore può essere inattivo prima di ottenere la notifica Device Power Not Required.

Sintassi

ULONG StorPortPoFxSetIdleTimeout(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS Address,
  ULONG         IdleTimeoutInMS
);

Parametri

HwDeviceExtension

[in] Puntatore all'estensione del dispositivo miniport.

Address

[in] Deve essere impostato su NULL perché questa funzione è supportata solo per gli adattatori. Non passare l'indirizzo di un'unità.

IdleTimeoutInMS

Intervallo di timeout di inattività da usare, espresso in millisecondi.

Valore restituito

storPortPoFxSetIdleTimeout restituisce STOR_STATUS_SUCCESS se l'alimentazione di runtime è stata disabilitata o se il valore di timeout di inattività è stato impostato correttamente. In caso contrario, restituisce un codice di errore, ad esempio uno dei seguenti.

Codice di errore Significato
STOR_STATUS_INVALID_PARAMETER È stato passato un indirizzo di unità.
STOR_STATUS_UNSUCCESSFUL La funzione StorPortInitializePoFxPower non è stata chiamata in precedenza per l'adattatore oppure non è stato impostato un valore di timeout di inattività.

Osservazioni

Se è stato specificato il flag di STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT e il AdapterIdleTimeoutInMS impostato quando la scheda è stata registrata per il risparmio energia di runtime, tale valore verrà sostituito da IdleTimeoutInMS valore passato a questa funzione. Per informazioni su come eseguire la registrazione per il risparmio energia in fase di esecuzione, vedere STOR_POFX_DEVICE_V3.

Un miniport può chiamare questa funzione solo se in precedenza ha chiamato StorPortInitializePoFxPower per l'adattatore.

Fabbisogno

Requisito Valore
client minimo supportato Windows 8
intestazione storport.h

Vedere anche

STOR_POFX_DEVICE_V3

StorPortInitializePoFxPower