PO_FX_DIRECTED_POWER_UP_CALLBACK Rückruffunktion (wdm.h)
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