PoStartNextPowerIrp 函数 (ntifs.h)

项目
02/29/2024

PoStartNextPowerIrp 例程向电源管理器表明驱动程序已准备好处理下一个电源 IRP。仅 (Windows Server 2003、Windows XP 和 Windows 2000。)

语法

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

参数

[in, out] Irp

指向在其中IRP_MJ_POWER主要函数代码的 IRP 的指针。

返回值

无

备注

从 Windows Vista 开始，驱动程序不需要调用 PoStartNextPowerIrp ，并且调用此例程不会执行电源管理操作。但是，在 Windows Server 2003、Windows XP 和 Windows 2000 上，设备堆栈中的每个驱动程序都必须调用 PoStartNextPowerIrp 后，驱动程序完成之前的电源 IRP（如果有），并准备好处理下一个电源 IRP。每个驱动程序必须针对每个 IRP_MN_QUERY_POWER 或 IRP_MN_SET_POWER 请求调用一次。

尽管电源 IRP 仅完成一次（通常由设备的总线驱动程序完成），但当 IRP 向下传输或备份堆栈时，设备堆栈中的每个驱动程序都必须调用 PoStartNextPowerIrp 。即使驱动程序未能通过 IRP，驱动程序也必须调用 PoStartNextPowerIrp ，以向电源管理器发出信号，它已准备好处理另一个电源 IRP。

当当前 IRP 堆栈位置指向当前驱动程序时，驱动程序必须调用 PoStartNextPowerIrp 。因此，必须在 IoCompleteRequest、 IoSkipCurrentIrpStackLocation 和 PoCallDriver 之前调用此例程。一般情况下，驱动程序应从其与 IRP 关联的 IoCompletion 例程或从传递给 PoRequestPowerIrp 的回调例程调用 PoStartNextPowerIrp。

在完成每个 IRP 之前，总线驱动程序必须调用 PoStartNextPowerIrp 。

要求

要求	值
最低受支持的客户端	Windows 2000。
目标平台	通用
标头	ntifs.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=DISPATCH_LEVEL