PoStartNextPowerIrp-Funktion (wdm.h)

Artikel
02/29/2024

Die PoStartNextPowerIrp-Routine signalisiert dem Energie-Manager , dass der Treiber bereit ist, die nächste Energie-IRP zu verarbeiten. (Nur Windows Server 2003, Windows XP und Windows 2000.)

Syntax

void PoStartNextPowerIrp(
  [in, out] PIRP Irp
);

Parameter

[in, out] Irp

Ein Zeiger auf eine IRP, in der der Hauptfunktionscode IRP_MJ_POWER wird.

Rückgabewert

Keine

Bemerkungen

Ab Windows Vista ist der Treiber nicht erforderlich, PoStartNextPowerIrp aufzurufen, und ein Aufruf dieser Routine führt keinen Energieverwaltungsvorgang aus. Unter Windows Server 2003, Windows XP und Windows 2000 muss PoStartNextPowerIrp jedoch von jedem Treiber in einem Gerätestapel aufgerufen werden, nachdem der Treiber mit dem vorherigen Energie-IRP (sofern vorhanden) fertig ist und bereit ist, die nächste Energie-IRP zu verarbeiten. Er muss von jedem Treiber einmal für jede IRP_MN_QUERY_POWER - oder IRP_MN_SET_POWER-Anforderung aufgerufen werden.

Obwohl Power IRPs nur einmal abgeschlossen werden, in der Regel vom Bustreiber für ein Gerät, muss jeder Treiber im Gerätestapel PoStartNextPowerIrp aufrufen, während der IRP den Stapel nach unten bewegt oder wieder hochgefahren wird. Selbst wenn ein Treiber das IRP ausfällt, muss der Treiber dennoch PoStartNextPowerIrp aufrufen, um dem Power Manager zu signalisieren, dass er bereit ist, eine andere Energie-IRP zu verarbeiten.

Der Treiber muss PoStartNextPowerIrp aufrufen, während der aktuelle IRP-Stapelspeicherort auf den aktuellen Treiber verweist. Daher muss diese Routine vor IoCompleteRequest, IoSkipCurrentIrpStackLocation und PoCallDriver aufgerufen werden. Im Allgemeinen sollte ein Treiber PoStartNextPowerIrp aus seiner IoCompletion-Routine aufrufen, die dem IRP zugeordnet ist, oder aus der Rückrufroutine, die er an PoRequestPowerIrp übergeben hat.

Bustreiber müssen PoStartNextPowerIrp aufrufen, bevor die einzelnen IRP abgeschlossen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=DISPATCH_LEVEL