PoFxReportDevicePoweredOn-Funktion (wdm.h)
Die PoFxReportDevicePoweredOn-Routine benachrichtigt das Energieverwaltungsframework (PoFx), dass das Gerät den angeforderten Übergang zum D0 -Energiezustand (vollständig aktiviert) abgeschlossen hat.
Syntax
void PoFxReportDevicePoweredOn(
[in] POHANDLE Handle
);
Parameter
[in] Handle
Ein Handle, das die Registrierung des Geräts mit dem Power Management Framework (PoFx) darstellt. Der Gerätetreiber hat dieses Handle zuvor von der PoFxRegisterDevice-Routine erhalten.
Rückgabewert
Keine
Bemerkungen
Der Treiber für ein registriertes Gerät muss PoFxReportDevicePoweredOn nach einem der folgenden Vorkommen aufrufen:
- PoFx ruft die DevicePowerRequiredCallback-Rückrufroutine des Treibers auf, um den Treiber zu benachrichtigen, dass das Gerät in den D0-Energiezustand wechseln muss.
- PoFx ruft die Rückrufroutine DirectedPowerUpCallback des Treibers auf, um den Treiber zu benachrichtigen, dass das Gerät in den D0-Energiezustand wechseln muss.
- PoFx sendet dem Treiber ein S0-IRP (eine IRP_MN_SET_POWER-Anforderung ), um den Treiber über einen ausstehenden Systemübergang in den S0-Energiezustand zu benachrichtigen.
Der Treiber muss PoFxReportDevicePoweredOn aufrufen, unabhängig davon, ob kein D0 IRP erforderlich ist, die D0 IRP-Anforderung fehlschlägt, die bereitgestellte D0-IRP erfolgreich ist oder ausfällt oder ob der S0-IRP erfolgreich ist oder fehlschlägt.
Der PoFxReportDevicePoweredOn-Aufruf kann während oder nach dem Rückruf erfolgen.
Für eine S0-IRP-Anforderung muss der Treiber diese Anforderung so schnell wie möglich ausführen, das Gerät in den D0-Energiezustand schalten und PoFxReportDevicePoweredOn aufrufen. Weitere Informationen finden Sie unter Handling a System Set-Power IRP in a Device Power Policy Owner.For more information, see Handling a System Set-Power IRP in a Device Power Policy Owner.For more information, see Handling a System Set-Power IRP in a Device Power Policy Owner.
Beim Eintrag zu PoFxReportDevicePoweredOn befindet sich das Gerät möglicherweise in einem nicht initialisierten D0-Energiezustand, in dem alle Komponenten des Geräts aktiviert sind. Als Reaktion auf den PoFxReportDevicePoweredOn-Aufruf konfiguriert PoFx das Gerät in einem initialisierten D0-Zustand. Während dieser Konfiguration wechselt PoFx so viele Komponenten wie möglich in Low-Power-Fx-Energiezustände.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8. |
| Zielplattform | Universell |
| Header | wdm.h |
| Bibliothek | Ntoskrnl.lib |
| DLL | Ntoskrnl.exe |
| IRQL | <= DISPATCH_LEVEL |