PoFxSetComponentResidency-Funktion (wdm.h)

Die PoFxSetComponentResidency-Routine legt die geschätzte Zeit fest, wie lange eine Komponente wahrscheinlich leer bleibt, nachdem die Komponente die Leerlaufbedingung eingegeben hat.

Syntax

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

Parameter

[in] Handle

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

[in] Component

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

[in] Residency

Die geschätzte Aufenthaltszeit in 100-Nanosekundeneinheiten. Dieser Parameter ist ein Hinweis auf PoFx darüber, wie lange die Komponente wahrscheinlich nach einem Übergang von der aktiven Bedingung zum Leerlauf bleiben soll. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Keine

Bemerkungen

Der Anruftreiber liefert eine geschätzte Aufenthaltszeit, die PoFx als Hinweis zum Verbessern der Leistung verwenden kann. PoFx verwendet diesen Hinweis, um einen geeigneten Fx-Zustand für eine Komponente auszuwählen, die sich in der Leerlaufbedingung befindet.

Der Gerätetreiber kann PoFxSetComponentResidency jedes Mal aufrufen, wenn eine Änderung unter Umständen eine Änderung in der geschätzten Aufenthaltszeit erfordert. Nach jedem Aufruf bleibt die neue geschätzte Aufenthaltszeit wirksam, bis der Treiber PoFxSetComponentResidency erneut aufruft, um es zu aktualisieren.

Wenn sich eine Komponente in der Leerlaufbedingung befindet, wenn PoFxSetComponentResidency aufgerufen wird, kann PoFx den Fx-Zustand der Komponente ändern, um die durch den Anrufer angegebene neue geschätzte Aufenthaltszeit zu erfüllen.

Anforderungen

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