PO_FX_COMPONENT_PERF_STATE_CALLBACK Rückruffunktion (wdm.h)

Artikel
02/07/2025

Die ComponentPerfStateCallback Rückrufroutine benachrichtigt den Treiber, dass die Anforderung zum Ändern des Leistungsstatus einer Komponente abgeschlossen ist.

Syntax

PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;

void PoFxComponentPerfStateCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Succeeded,
  [in] PVOID RequestContext
)
{...}

Parameter

[in] Context

Ein Zeiger auf den Gerätekontext. Der Gerätetreiber verwendet diesen Kontext, um Informationen zum aktuellen Energiezustand des Geräts zu speichern. Der Gerätetreiber hat diesen Zeiger im DeviceContext Member der PO_FX_DEVICE Struktur angegeben, mit der der Treiber das Gerät mit dem Power Management Framework (PoFx) registriert hat. Dieser Kontext ist undurchsichtig für PoFx.

[in] Component

Gibt den Index an, der die Komponente identifiziert. Dieser Parameter ist ein Index im Components Array in der PO_FX_DEVICE Struktur, mit der der Gerätetreiber das Gerät bei PoFx registriert hat. Wenn das Components Array N-Elemente enthält, reichen Komponentenindizes von 0 bis N-1.

[in] Succeeded

Wenn TRUE, konnte das Plattformerweiterungs-Plug-In (PEP) die Leistungszustandsänderung erfolgreich sein. Wenn FALSCH, hat der PEP die Leistungszustandsänderung nicht bestanden. Weitere Informationen finden Sie im Abschnitt "Hinweise".

[in] RequestContext

Zeiger auf den optionalen Treiber- oder Gerätekontext, der vom parameter Context des PoFxIssueComponentPerfStateChange oder PoFxIssueComponentPerfStateChangeMultiple Routine angegeben wurde.

Rückgabewert

Nichts

Bemerkungen

Wenn ein Gerätetreiber eine Leistungsstatusänderung anfordert, indem die PoFxIssueComponentPerfStateChange oder PoFxIssueComponentPerfStateChangeMultiple Routine aufgerufen wird, ruft PoFx die ComponentPerfStateCallback Routine auf, um den Treiber zu benachrichtigen, wenn die Anforderung abgeschlossen ist.

Um eine ComponentPerfStateCallback- Routine anzugeben, verwenden Sie den ComponentPerfStateCallback Parameter des PoFxRegisterComponentPerfStates Routine, wenn der Treiber für die Leistungsstatusverwaltung durch PoFx registriert wird. Die ComponentPerfStateCallback- Routine kann für alle Komponenten und alle Geräte identisch sein.

Wenn Erfolgreich ist, sollte der Treiber alle Erforderlichen ausführen, um den Leistungszustand in der Hardware zu ändern. Wenn Erfolgreich ist, kann der Treiber auswählen, dass keine Aktion ausgeführt wird, oder die Anforderung mit demselben Leistungsstatus oder einem alternativen Leistungsstatus wiederholen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Wird ab Windows 10 unterstützt.
Zielplattform-	Desktop
Header-	wdm.h
IRQL-	Wird bei IRQL <= DISPATCH_LEVEL aufgerufen.

Siehe auch

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice

Freigeben über