PcRequestNewPowerState-Funktion (portcls.h)

Die PcRequestNewPowerState Funktion wird verwendet, um einen neuen Energiezustand für das Gerät anzufordern. Diese Funktion wird in der Regel nicht von Adaptertreibern 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 (FDO) des Adapters. Dieser Parameter muss auf eine Systemstruktur vom Typ DEVICE_OBJECTverweisen.

[in] RequestedNewState

Gibt den angeforderten Gerätestromstatus an. Legen Sie diesen Parameter auf einen der folgenden DEVICE_POWER_STATE Enumerationswerte fest: PowerDeviceD0, PowerDeviceD1, PowerDeviceD2oder PowerDeviceD3.

Rückgabewert

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

Bemerkungen

Ein Adaptertreiber kann PcRequestNewPowerState- aufrufen, um Hardwareentwurfsfehler auszugleichen. 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 zuerst ein bestimmter Unterabsatz heruntergefahren wird.

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

Power State	Bedeutung
PowerDeviceD0-	Vollleistungszustand
PowerDeviceD1-	Der Ruhezustand mit der niedrigsten Energielatenz
PowerDeviceD2-	Ein mittlerer Ruhezustand
PowerDeviceD3-	Ein vollständiger Ruhezustand und der Ruhezustand mit der längsten Energie-Up-Latenz

 

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

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Der PortCls-Systemtreiber implementiert die PcRequestNewPowerState-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höher.
Zielplattform-	Universal
Header-	portcls.h (include Portcls.h)
Library	Portcls.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

DEVICE_OBJECT