PoFxSetComponentWake-Funktion (wdm.h)

Die PoFxSetComponentWake-Routine gibt an, ob der Treiber die angegebene Komponente aktiviert, wenn die Komponente in den Leerlauf wechselt.

Syntax

void PoFxSetComponentWake(
  [in] POHANDLE Handle,
  [in] ULONG    Component,
  [in] BOOLEAN  WakeHint
);

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.

[in] Component

Der Index, der die Komponente identifiziert. Dieser Parameter ist ein Index im Komponentenarray in der PO_FX_DEVICE Struktur, die der Gerätetreiber zum Registrieren des Geräts bei PoFx verwendet hat. Wenn das Komponentenarray N-Elemente enthält, reichen die Komponentenindizes von 0 bis N–1.

[in] WakeHint

Gibt an, ob der Treiber die Komponente aktiviert, wenn die Komponente in den Leerlauf wechselt. True gibt an, dass der Treiber die Komponente reaktivieren kann. False gibt an, dass der Treiber die Komponente nicht reaktivieren kann.

Rückgabewert

Keine

Bemerkungen

Bevor eine Komponente in einen Fx-Zustand mit niedriger Leistung wechselt, kann der Treiber die Komponente so ausrüsten, dass sie als Reaktion auf ein Eingabesignal von einer externen Quelle automatisch reaktiviert wird (z. B. wenn der Benutzer eine Taste drückt). Der Parameter WakeHint informiert PoFx, ob der Treiber die Komponente zum Reaktivieren ausgibt. Wenn eine Komponente zum Reaktivieren bewaffnet ist, wechselt PoFx die Komponente nicht in einen Fx-Zustand mit niedriger Leistung, aus dem die Komponente nicht reaktiviert werden kann.

Wenn ein Gerät bei PoFx registriert wird, sind die Registrierungsinformationen für jede Komponente im Gerät in einer separaten PO_FX_COMPONENT-Struktur enthalten. Der DeepestWakeableIdleState-Member dieser Struktur gibt den tiefsten Fx-Zustand an, aus dem die Komponente reaktivieren kann.

Der Gerätetreiber kann PoFxSetComponentWake jedes Mal aufrufen, wenn eine Änderung der Bedingungen eine Änderung des WakeHint-Werts erfordert. Nach jedem Aufruf bleibt der neue WakeHint-Wert wirksam, bis der Treiber PoFxSetComponentWake erneut aufruft, um ihn zu aktualisieren.

Wenn sich eine Komponente im Leerlauf befindet, wenn PoFxSetComponentWake aufgerufen wird, ändert PoFx möglicherweise den Fx-Zustand der Komponente, um den vom Aufrufer angegebenen neuen WakeHint-Parameterwert aufzunehmen.

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

PO_FX_COMPONENT