Freigeben über

PO_FX_DIRECTED_POWER_UP_CALLBACK Rückruffunktion (wdm.h)

  • Artikel

Die PO_FX_DIRECTED_POWER_UP_CALLBACK Rückruffunktion wird vom Clienttreiber implementiert, um treiberspezifische Power-Up-Aktivitäten im Auftrag von DFx (Directed PoFx) zu verarbeiten.

Syntax

PO_FX_DIRECTED_POWER_UP_CALLBACK PoFxDirectedPowerUpCallback;

void PoFxDirectedPowerUpCallback(
  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 registrieren, müssen diesen Rückruf implementieren, um DFx-Unterstützung hinzuzufügen.

Registrieren Sie Ihre Implementierung dieser Rückruffunktion, indem Sie das entsprechende Element der PO_FX_DEVICE_V3-Struktur festlegen und dann PoFxRegisterDevice aufrufen.

Dieser Rückruf wird aufgerufen, wenn das System feststellt, dass das Gerät eingeschaltet werden muss, nachdem zuvor in der PO_FX_DIRECTED_POWER_DOWN_CALLBACK Rückruffunktion heruntergefahren wurde. Das Gerät muss möglicherweise eingeschaltet werden, wenn das System Modern Standby beendet, Aktivatoren ausgeführt werden oder eine hardwareinitiierte Aktivierung erfolgt.

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

  • Fordern Sie eine D0-IRP an, um das Gerät einzuschalten.

  • Rufen Sie nach Abschluss des D0-IRP PoFxReportDevicePoweredOn auf.

  • Heben Sie die Blockierung von E/A-Warteschlangen auf, und beginnen Sie mit der normalen Verarbeitung von Anforderungen.

Sobald der Treiber den Aufruf zum gerichteten Einschalten abgeschlossen hat, kann er das RtD3-Verhalten (Runtime-Leerlauf) fortsetzen.

Der Vertrag ist sehr ähnlich wie S0, obwohl keine S-IRPs beteiligt sind.

Beachten Sie, dass das gerichtete Energieframework die untergeordneten Geräte vor dem übergeordneten Gerät zum Ausschalten auffordern, wenn eine Gerätehierarchie betroffen ist. Für ein bestimmtes übergeordnetes Gerät werden direkte untergeordnete (vom übergeordneten Gerät aufgezählte) und indirekte untergeordnete Elemente aufgrund von Machtverhältnissen berücksichtigt.

Anforderungen

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

Weitere Informationen

Einführung in das Framework zur gesteuerten Energieverwaltung

PO_FX_DIRECTED_POWER_DOWN_CALLBACK