StorPortPoFxSetIdleTimeout-Funktion (storport.h)
Ein Miniport kann StorPortPoFxSetIdleTimeout aufrufen, um den Leerlauftimeoutwert für einen Adapter festzulegen. Dies ist die Zeitspanne, die sich ein Adapter im Leerlauf befinden kann, bevor er die Benachrichtigung Geräteleistung nicht erforderlich erhält.
Syntax
ULONG StorPortPoFxSetIdleTimeout(
PVOID HwDeviceExtension,
PSTOR_ADDRESS Address,
ULONG IdleTimeoutInMS
);
Parameter
HwDeviceExtension
[in] Zeiger auf die Geräteerweiterung des Miniports.
Address
[in] Muss auf NULL festgelegt werden, da diese Funktion nur für Adapter unterstützt wird. Geben Sie die Adresse einer Einheit nicht weiter.
IdleTimeoutInMS
Das zu verwendende Leerlauftimeoutintervall in Millisekunden.
Rückgabewert
StorPortPoFxSetIdleTimeout gibt STOR_STATUS_SUCCESS zurück, wenn die Laufzeitleistung deaktiviert wurde oder wenn der Leerlauftimeoutwert erfolgreich festgelegt wurde. Andernfalls wird ein Fehlercode wie einer der folgenden zurückgegeben.
| Fehlercode | Bedeutung |
|---|---|
| STOR_STATUS_INVALID_PARAMETER | Eine Einheitsadresse wurde übergeben. |
| STOR_STATUS_UNSUCCESSFUL | Die StorPortInitializePoFxPower-Funktion wurde zuvor nicht erfolgreich für den Adapter aufgerufen, oder ein Leerlauftimeoutwert wurde nicht festgelegt. |
Hinweise
Wenn das flag STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT angegeben wurde und adapterIdleTimeoutInMS festgelegt wurde, als der Adapter für die Laufzeitenergieverwaltung registriert wurde, wird dieser Wert durch den an diese Funktion übergebenen IdleTimeoutInMS-Wert überschrieben. Informationen zur Registrierung für die Laufzeitenergieverwaltung finden Sie unter STOR_POFX_DEVICE_V3 .
Ein Miniport kann diese Funktion nur aufrufen, wenn er zuvor StorPortInitializePoFxPower für den Adapter aufgerufen hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Kopfzeile | storport.h |