PcRequestNewPowerState-Funktion (portcls.h)

  • Artikel

Die PcRequestNewPowerState-Funktion wird verwendet, um einen neuen Energiezustand für das Gerät anzufordern. Diese Funktion wird in der Regel von Adaptertreibern nicht benötigt, kann aber gelegentlich hilfreich sein, um einige Arten von Hardwareproblemen zu umgehen.

Syntax

PORTCLASSAPI NTSTATUS PcRequestNewPowerState(
  [in] PDEVICE_OBJECT     pDeviceObject,
  [in] DEVICE_POWER_STATE RequestedNewState
);

Parameter

[in] pDeviceObject

Zeiger auf das funktionale Geräteobjekt (Functional Device Object, FDO) des Adapters. Dieser Parameter muss auf eine Systemstruktur vom Typ DEVICE_OBJECT verweisen.

[in] RequestedNewState

Gibt den angeforderten Energiezustand des Geräts an. Legen Sie diesen Parameter auf einen der folgenden DEVICE_POWER_STATE-Enumerationswerte fest: PowerDeviceD0, PowerDeviceD1, PowerDeviceD2 oder PowerDeviceD3.

Rückgabewert

PcRequestNewPowerState gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird eine entsprechende Fehlermeldung zurückgegeben.

Hinweise

Ein Adaptertreiber kann PcRequestNewPowerState aufrufen, um Hardwareentwurfsfehler zu kompensieren. Wenn die Funktionen in einem Audioadapter beispielsweise nicht gegenseitig unabhängig sind und in einer bestimmten Reihenfolge heruntergefahren werden müssen, kann der Adapter PcRequestNewPowerState aufrufen, um sicherzustellen, dass ein bestimmtes Untergerät zuerst heruntergefahren wird.

Der RequestedNewState-Parameter kann auf einen der DEVICE_POWER_STATE Enumerationswerte in der folgenden Tabelle festgelegt werden.

Betriebszustand Bedeutung
PowerDeviceD0 Vollständiger Energiezustand
PowerDeviceD1 Der Standbyzustand mit der niedrigsten Einschaltwartezeit
PowerDeviceD2 Ruhezustand mit mittlerer Latenz
PowerDeviceD3 Ein vollständiger Ruhezustand und der Ruhezustand mit der längsten Einschaltwartezeit
 

Auf die Hardware kann nur im Energiezustand PowerDeviceD0 zugegriffen werden. In jedem anderen Zustand muss der Treiber alle versuchten Hardwarezugriffe zwischenspeichern und diese Zugriffe zurückstellen, bis der PowerDeviceD0-Zustand wiederhergestellt ist.

Weitere Informationen finden Sie unter Energieverwaltung für Audiogeräte.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Der PortCls-Systemtreiber implementiert die PcRequestNewPowerState-Funktion in Microsoft Windows 98/Me und windows 2000 und höher.
Zielplattform Universell
Header portcls.h (portcls.h einschließen)
Bibliothek Portcls.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

DEVICE_OBJECT