IPortClsPower::SetIdlePowerManagement-Methode (portcls.h)

  • Artikel

Die SetIdlePowerManagement -Methode bietet dem Adaptertreiber die Möglichkeit, die Erkennung des Leerlaufzustands zu aktivieren oder zu deaktivieren.

Syntax

NTSTATUS SetIdlePowerManagement(
  [in] PDEVICE_OBJECT _DeviceObject,
  [in] BOOLEAN        _bEnabled
);

Parameter

[in] _DeviceObject

Gibt einen Zeiger auf eine DEVICE_OBJECT-Struktur an, die das funktionale Geräteobjekt des Adapters darstellt.

[in] _bEnabled

Gibt eine boolesche Variable an, die angibt, ob die Erkennung des Leerlaufzustands aktiviert oder deaktiviert ist.

Rückgabewert

Die SetIdlePowerManagement -Methode gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird der entsprechende Fehlercode zurückgegeben.

Hinweise

Wenn der bEnabled-Parameter auf TRUE festgelegt ist, gibt dies an, dass der Adaptertreiber die Erkennung des Leerlaufzustands aktiviert hat. Wenn das System feststellt, dass sich der Adapter im Leerlauf befindet, kann der Adapter in den Energiesparmodus versetzt werden, um Strom zu sparen. Wenn der Adapter nicht für die Unterdrückung des Popupsounds konzipiert wurde, der normalerweise mit dem Einschalten verbunden ist, ist es möglich, dass der Adapter einen Popping-Effekt erleben kann, wenn er aus dem Ruhezustand kommt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 7 und späteren Windows-Versionen.
Zielplattform Universell
Header portcls.h (portcls.h einschließen)
IRQL PASSIVE_LEVEL.

Weitere Informationen

DEVICE_OBJECT

IPortClsPower

Sofortiges Leerlauftimeout