PO_FX_DIRECTED_POWER_DOWN_CALLBACK Rückruffunktion (wdm.h)

Die PO_FX_DIRECTED_POWER_DOWN_CALLBACK Rückruffunktion wird vom Clienttreiber implementiert, um treiberspezifische Abschaltaktivitäten im Auftrag von DFx (Directed PoFx) zu verarbeiten.

Syntax

PO_FX_DIRECTED_POWER_DOWN_CALLBACK PoFxDirectedPowerDownCallback;

void PoFxDirectedPowerDownCallback(
  PVOID Context,
  ULONG Flags
)
{...}

Parameter

Context

Stellt einen Zeiger auf den Kontext bereit, der an PoFxRegisterDevice übergeben wird.

Flags

Für die zukünftige Verwendung reserviert.

Rückgabewert

Keine

Bemerkungen

WDM-Treiber, die sich bei PoFx für die Unterstützung der Energieverwaltung im Leerlauf der Laufzeit registrieren, müssen diesen Rückruf implementieren, um DFx-Unterstützung hinzuzufügen.

Registrieren Sie Ihre Implementierung dieser Rückruffunktion, indem Sie den entsprechenden Member der PO_FX_DEVICE_V3-Struktur festlegen und dann PoFxRegisterDevice aufrufen.

Dieser Rückruf wird während einer Modern Standby-Sitzung aufgerufen, wenn dieses Gerät oder ein von diesem Gerät abhängiger DRIPS-Eintrag für mindestens zwei aufeinander folgende Minuten (vom Treiber konfigurierbares Timeout, Standard 2 Minuten) blockiert hat, ohne dass eine Aktivierungsbroker-Softwareaktivität ausgeführt wird.

Wenn dieser Rückruf aufgerufen wird, führt der Treiber in der Regel die folgenden allgemeinen Aufgaben aus:

  • Beenden Sie die Verarbeitung neuer Arbeit.

  • Wechseln Sie sofort in den Energiesparmodus.

  • Bleiben Sie im Energiesparmodus, bis das System die PO_FX_DIRECTED_POWER_UP_CALLBACK des Treibers aufruft.

Implementierungsschritte und Reihenfolge können variieren, können jedoch einige der folgenden Elemente umfassen:

  • Fordern Sie eine Dx-IRP an.

  • Nachdem das Dx IRP eingetroffen ist, blockieren Sie E/A-Warteschlangen.

  • Warten Sie, bis laufende Vorgänge abgeschlossen sind.

  • Wenn diese Vorgänge zu lange dauern, brechen Sie sie optional ab.

  • Führen Sie Aktionen aus, die für den Übergang des Geräts in Dx erforderlich sind (z. B. Speichern des Hardwarezustands).

  • Arm zum Aufwachen nach Bedarf.

  • Rufen Sie PoFxCompleteDirectedPowerDown auf.

  • Bleiben Sie in Dx, bis das System PO_FX_DIRECTED_POWER_UP_CALLBACK aufruft.

Der Vertrag ist S3/S4 sehr ähnlich, obwohl keine S-IRPs beteiligt sind.

Wenn eine Gerätehierarchie beteiligt ist, fordert das gerichtete Energieframework die untergeordneten Geräte auf, vor dem übergeordneten Gerät herunterzuschalten. Für ein bestimmtes übergeordnetes Gerät werden direkte (vom übergeordneten Gerät aufgezählte) und indirekte untergeordnete Elemente aufgrund von Machtbeziehungen berücksichtigt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1903
Kopfzeile wdm.h (wdm.h einschließen)

Weitere Informationen

Einführung in das Framework zur gesteuerten Energieverwaltung

PO_FX_DIRECTED_POWER_UP_CALLBACK