PoFxStartDevicePowerManagement-Funktion (wdm.h)

  • Artikel

Die PoFxStartDevicePowerManagement-Routine schließt die Registrierung eines Geräts mit dem Power Management Framework (PoFx) ab und startet die Geräteenergieverwaltung.

Syntax

void PoFxStartDevicePowerManagement(
  [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

Nachdem ein Treiber die PoFxRegisterDevice-Routine aufgerufen hat , um ein Gerät mit PoFx zu registrieren, sind alle Komponenten des Geräts vollständig aktiviert und im aktiven Zustand, sodass der Treiber die Initialisierung der Hardware beenden kann. Um die aktive Energieverwaltung zu starten, muss der Treiber PoFxStartDevicePowerManagement aufrufen. Standardmäßig wechselt dieser Aufruf alle Komponenten in die Leerlaufbedingung.

Nachdem PoFxStartDevicePowerManagement eine Komponente in den Leerlauf wechselt, kann PoFx sofort mit dem Aufruf der Rückrufroutinen des Treibers beginnen, auch bevor PoFxStartDevicePowerManagement zurückgibt. PoFx ruft die ComponentIdleConditionCallback-Rückrufroutine des Treibers auf, um anzugeben, dass eine Komponente zur Leerlaufbedingung gewechselt ist. Der Treiber darf nicht auf eine Komponente zugreifen, die sich im Leerlauf befindet. Bevor der Treiber auf die Komponente zugreifen kann, muss der Treiber poFxActivateComponent aufrufen und warten, bis PoFx die ComponentActiveConditionCallback-Rückrufroutine des Treibers aufruft. Dieser Rückruf informiert den Treiber darüber, dass sich die Komponente im aktiven Zustand befindet und sicher zugegriffen werden kann.

Wenn der Treiber erfordert, dass sich eine Komponente unmittelbar nach dem Start der Energieverwaltung im aktiven Zustand befindet, muss der Treiber die Komponente explizit aktivieren, indem er die PoFxActivateComponent-Routine aufruft. Dieser Aufruf muss nach dem PoFxRegisterDevice-Aufruf , aber vor dem PoFxStartDevicePowerManagement-Aufruf erfolgen.

Anforderungen

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

Weitere Informationen

ComponentActiveConditionCallback

ComponentIdleConditionCallback

PoFxActivateComponent

PoFxRegisterDevice