PoFxSetComponentResidency-Funktion (wdm.h)

Artikel
02/29/2024

Die PoFxSetComponentResidency-Routine legt die geschätzte Zeit fest, wie lange eine Komponente wahrscheinlich im Leerlauf bleibt, nachdem die Komponente in die Leerlaufbedingung gelangt ist.

Syntax

void PoFxSetComponentResidency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Residency
);

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 in das Array Components 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] Residency

Die geschätzte Aufenthaltsdauer in 100 Nanosekundeneinheiten. Dieser Parameter ist ein Hinweis auf PoFx, wie lange die Komponente nach einem Übergang von der aktiven Bedingung zur Leerlaufbedingung wahrscheinlich im Leerlauf verbleibt. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Keine

Bemerkungen

Der aufrufende Treiber gibt eine geschätzte Aufenthaltsdauer an, die PoFx als Hinweis zur Verbesserung der Leistung verwenden kann. PoFx verwendet diesen Hinweis, um einen geeigneten Fx-Zustand mit geringer Leistung für eine Komponente auszuwählen, die sich im Leerlauf befindet.

Der Gerätetreiber kann PoFxSetComponentResidency jedes Mal aufrufen, wenn eine Änderung der Umstände eine Änderung der geschätzten Aufenthaltsdauer erfordert. Nach jedem Aufruf bleibt die neue geschätzte Residenzzeit gültig, bis der Treiber PoFxSetComponentResidency erneut aufruft , um sie zu aktualisieren.

Wenn sich eine Komponente im Leerlauf befindet, wenn PoFxSetComponentResidency aufgerufen wird, kann PoFx den Fx-Zustand der Komponente ändern, um die vom Aufrufer angegebene neue geschätzte Residenzzeit zu berücksichtigen.

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

Freigeben über