通过

PoFxPowerOnCrashdumpDevice 函数 (wdm.h)

  • 项目

PoFxPowerOnCrashdumpDevice 例程请求启用故障转储设备。

语法

NTSTATUS PoFxPowerOnCrashdumpDevice(
  [in]           POHANDLE Handle,
  [in, optional] PVOID    Context
);

参数

[in] Handle

表示向 Windows 电源管理框架 注册故障转储设备的句柄， (PoFx) 。 设备驱动程序以前从 PoFxRegisterDevice 例程收到此句柄。

[in, optional] Context

指向特定于设备的上下文的指针。 此指针作为输入参数传递到 PowerOnDumpDeviceCallback 回调例程，该平台扩展插件 (设备的 PEP) 实现该例程。 上下文信息以设备驱动程序定义并由 PEP 理解的格式存储。 此上下文对操作系统不透明。 如果 PEP 不需要上下文，则驱动程序可以将此参数设置为 NULL。

返回值

如果例程成功打开设备的电源，PoFxPowerOnCrashdumpDevice 将返回STATUS_SUCCESS。 可能的错误返回值包括以下状态代码。

返回值 说明
STATUS_INVALID_PARAMETER
 不是有效的句柄值。
STATUS_UNSUCCESSFUL
 此设备的 PEP 不实现 PowerOnDumpDeviceCallback 回调例程;或 PEP 无法打开设备。

注解

故障转储设备的驱动程序调用此例程，以请求平台扩展插件 (PEP) 打开设备，以便可以保存故障转储。 故障转储设备链中的所有设备 (可能包括存储控制器、PCI 控制器等) ，然后才能将故障转储文件写入磁盘。

有关故障转储的详细信息，请参阅 内核模式转储文件。

可以在 IRQL <= HIGH_LEVEL 调用此例程。

要求

要求 值
最低受支持的客户端 从Windows 8.1开始可用。
目标平台 Windows
标头 wdm.h (包括 Pepfx.h)
Library Ntoskrnl.lib
IRQL <= HIGH_LEVEL

另请参阅

PoFxRegisterDevice

PowerOnDumpDeviceCallback