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 (Direkt 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
Reserviert für die zukünftige Verwendung.
Rückgabewert
Nichts
Bemerkungen
WDM-Treiber, die sich bei PoFx für die Unterstützung für das Leerlauf-Energiemanagement registrieren, müssen diesen Rückruf implementieren, um DFx-Unterstützung hinzuzufügen.
Registrieren Sie die Implementierung dieser Rückruffunktion, indem Sie das entsprechende Element der PO_FX_DEVICE_V3-Struktur festlegen und dann PoFxRegisterDeviceaufrufen.
Dieser Rückruf wird aufgerufen, wenn das System bestimmt, dass das Gerät hochgeschaltet werden muss, nachdem es zuvor in der PO_FX_DIRECTED_POWER_DOWN_CALLBACK Rückruffunktion heruntergefahren wurde. Das Gerät muss möglicherweise eingeschaltet werden, wenn das System den modernen Standbymodus verlässt, Aktivatoren starten oder eine hardwaregesteuerte Aktivierung auftritt.
Wenn dieser Rückruf aufgerufen wird, führt der Treiber in der Regel die folgenden allgemeinen Aufgaben aus:
Fordern Sie einen D0 IRP an, um das Gerät hochzuschalten.
Rufen Sie nach Abschluss der D0 IRP PoFxReportDevicePoweredOnauf.
Heben Sie die Blockierung von E/A-Warteschlangen auf, und starten Sie die Verarbeitung von Anforderungen normal.
Nachdem der Treiber den Aufruf des weitergeleiteten Einschaltens abgeschlossen hat, kann er das Laufzeit-IdD3-Verhalten (Runtime-Idle, RTD3) fortsetzen.
Der Vertrag ist S0 sehr ähnlich, obwohl keine S-IRPs beteiligt sind.
Beachten Sie, dass das gerichtete Power Framework, wenn eine Gerätehierarchie beteiligt ist, die untergeordneten Geräte auffordern, vor dem übergeordneten Gerät herunterzuschalten. Für ein bestimmtes übergeordnetes Gerät werden direkte untergeordnete Elemente (durch das Elternteil aufgezählt) und indirekte Untergeordnete aufgrund Power Relations berücksichtigt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1903 |
| Header- | wdm.h (include Wdm.h) |