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 |