StorPortPoFxSetIdleTimeout-Funktion (storport.h)
Ein Miniport kann StorPortPoFxSetIdleTimeout- aufrufen, um den Leerlauftimeoutwert für einen Adapter festzulegen. Dies ist die Zeit, die ein Adapter im Leerlauf ausführen kann, bevor er die Benachrichtigung "Device Power Not Required" 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. Übergeben Sie nicht die Adresse einer Einheit.
IdleTimeoutInMS
Das zu verwendende Leerlauftimeoutintervall in Millisekunden.
Rückgabewert
StorPortPoFxSetIdleTimeout- gibt STOR_STATUS_SUCCESS zurück, wenn die Laufzeitleistung deaktiviert wurde oder der Leerlauftimeoutwert erfolgreich festgelegt wurde. Andernfalls wird ein Fehlercode zurückgegeben, z. B. einer der folgenden.
| Fehlercode | Bedeutung |
|---|---|
| STOR_STATUS_INVALID_PARAMETER | Eine Einheitenadresse wurde übergeben. |
| STOR_STATUS_UNSUCCESSFUL | Die StorPortInitializePoFxPower--Funktion wurde zuvor nicht erfolgreich für den Adapter aufgerufen, oder ein Leerlauftimeoutwert wurde nicht festgelegt. |
Bemerkungen
Wenn das STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT Flag angegeben wurde und die AdapterIdleTimeoutInMS festgelegt, als der Adapter für die Laufzeit-Energieverwaltung registriert wurde, wird dieser Wert von IdleTimeoutInMS an diese Funktion übergebenen Wert überschrieben. Informationen zum Registrieren für die Laufzeit-Energieverwaltung finden Sie unter STOR_POFX_DEVICE_V3.
Ein Miniport kann diese Funktion nur aufrufen, wenn sie zuvor StorPortInitializePoFxPower- für den Adapter aufgerufen hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| Header- | storport.h |