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 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 |