PoFxSetTargetDripsDevicePowerState-Funktion (wdm.h)

Diese Routine wird aufgerufen, um den Energie-Manager über den Energiezustand des Zielgeräts für DRIPS zu benachrichtigen. Der Treiber kann die vom PEP bereitgestellte DRIPS-Einschränkung außer Kraft setzen.

Syntax

NTSTATUS PoFxSetTargetDripsDevicePowerState(
  [in] POHANDLE           Handle,
  [in] DEVICE_POWER_STATE TargetState
);

Parameter

[in] Handle

Ein Handle, das die Registrierung des Geräts bei PoFx darstellt. Der Gerätetreiber hat dieses Handle zuvor von der PoFxRegisterDevice-Routine erhalten.

[in] TargetState

Gibt den Energiezustand des DRIPS-Zielgeräts an. Mögliche Werte werden in der DEVICE_POWER_STATE-Enumeration definiert. Dieser Wert muss niedriger als die vorhandene Geräteeinschränkung sein. Ein Geräteleistungszustand von PowerDeviceUnspecified wird auf die von PEP bereitgestellte Einschränkung zurückgesetzt.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Zielzustand akzeptiert wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1709
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
Kopfzeile wdm.h
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe (Kernelmodus)
IRQL PASSIVE_LEVEL