PoFxReportDevicePoweredOn-Funktion (wdm.h)

  • Artikel

Die PoFxReportDevicePoweredOn-Routine benachrichtigt das Energieverwaltungsframework (PoFx), dass das Gerät den angeforderten Übergang zum D0 -Energiezustand (vollständig aktiviert) abgeschlossen hat.

Syntax

void PoFxReportDevicePoweredOn(
  [in] POHANDLE Handle
);

Parameter

[in] Handle

Ein Handle, das die Registrierung des Geräts mit dem Power Management Framework (PoFx) darstellt. Der Gerätetreiber hat dieses Handle zuvor von der PoFxRegisterDevice-Routine erhalten.

Rückgabewert

Keine

Bemerkungen

Der Treiber für ein registriertes Gerät muss PoFxReportDevicePoweredOn nach einem der folgenden Vorkommen aufrufen:

Als Reaktion auf beides sendet der Treiber D0 IRP (eine IRP_MN_SET_POWER-Anforderung ) in seinen Gerätestapel, um einen Übergang in den D0-Energiezustand zu initiieren, wenn sich das Gerät noch nicht im D0-Zustand befindet. Nachdem der Treiber den Übergang zum D0-Zustand abgeschlossen hat (und alle niedrigeren Treiber abgeschlossen sind), ruft der Treiber PoFxReportDevicePoweredOn auf, um PoFx zu benachrichtigen.

Der Treiber muss PoFxReportDevicePoweredOn aufrufen, unabhängig davon, ob kein D0 IRP erforderlich ist, die D0 IRP-Anforderung fehlschlägt, die bereitgestellte D0-IRP erfolgreich ist oder ausfällt oder ob der S0-IRP erfolgreich ist oder fehlschlägt.

Der PoFxReportDevicePoweredOn-Aufruf kann während oder nach dem Rückruf erfolgen.

Für eine S0-IRP-Anforderung muss der Treiber diese Anforderung so schnell wie möglich ausführen, das Gerät in den D0-Energiezustand schalten und PoFxReportDevicePoweredOn aufrufen. Weitere Informationen finden Sie unter Handling a System Set-Power IRP in a Device Power Policy Owner.For more information, see Handling a System Set-Power IRP in a Device Power Policy Owner.For more information, see Handling a System Set-Power IRP in a Device Power Policy Owner.

Beim Eintrag zu PoFxReportDevicePoweredOn befindet sich das Gerät möglicherweise in einem nicht initialisierten D0-Energiezustand, in dem alle Komponenten des Geräts aktiviert sind. Als Reaktion auf den PoFxReportDevicePoweredOn-Aufruf konfiguriert PoFx das Gerät in einem initialisierten D0-Zustand. Während dieser Konfiguration wechselt PoFx so viele Komponenten wie möglich in Low-Power-Fx-Energiezustände.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 8.
Zielplattform Universell
Header wdm.h
Bibliothek Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL

Weitere Informationen

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PoFxRegisterDevice