PO_FX_COMPONENT_PERF_STATE_CALLBACK Rückruffunktion (wdm.h)

  • Artikel

Die Rückrufroutine ComponentPerfStateCallback benachrichtigt den Treiber, dass seine Anforderung zum Ändern des Leistungszustands 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-Element der PO_FX_DEVICE-Struktur angegeben, die der Treiber zum Registrieren des Geräts beim Power Management Framework (PoFx) verwendet hat. Dieser Kontext ist für PoFx undurchsichtig.

[in] Component

Gibt den Index an, 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] Succeeded

Wenn TRUE, konnte das Plattformerweiterungs-Plug-In (PEP) die Leistungszustandsänderung erfolgreich ändern. Bei FALSE ist die Änderung des Leistungszustands für PEP fehlgeschlagen. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

[in] RequestContext

Zeiger auf den optionalen Treiber- oder Gerätekontext, der durch den Context-Parameter der Routine PoFxIssueComponentPerfStateChange oder PoFxIssueComponentPerfStateChangeMultiple angegeben wurde.

Rückgabewert

Keine

Bemerkungen

Wenn ein Gerätetreiber eine Änderung des Leistungszustands durch Aufrufen der Routine PoFxIssueComponentPerfStateChange oder PoFxIssueComponentPerfStateChangeMultiple anfordert, ruft PoFx die ComponentPerfStateCallback-Routine auf, um den Treiber zu benachrichtigen, wenn die Anforderung abgeschlossen ist.

Verwenden Sie zum Angeben einer ComponentPerfStateCallback-Routine den ComponentPerfStateCallback-Parameter der PoFxRegisterComponentPerfStates-Routine , wenn sich der Treiber für die Leistungszustandsverwaltung durch PoFx registriert. Die ComponentPerfStateCallback-Routine kann für alle Komponenten und alle Geräte identisch sein.

Wenn Erfolgreich auf TRUE festgelegt ist, sollte der Treiber alle erforderlichen Aufgaben ausführen, um den Leistungszustand in der Hardware zu ändern. Wenn Erfolgreich auf FALSE festgelegt ist, kann der Treiber keine Aktion ausführen oder die Anforderung mit demselben Leistungszustand oder einem alternativen Leistungszustand wiederholen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt ab Windows 10.
Zielplattform Desktop
Kopfzeile wdm.h
IRQL Wird unter IRQL <= DISPATCH_LEVEL aufgerufen.

Weitere Informationen

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice