PoFxRegisterCrashdumpDevice 函数 (wdm.h)

PoFxRegisterCrashdumpDevice 例程注册故障转储设备。

语法

NTSTATUS PoFxRegisterCrashdumpDevice(
  POHANDLE Handle
);

Handle

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

如果例程成功注册故障转储设备，PoFxRegisterCrashdumpDevice 将返回STATUS_SUCCESS。可能的错误返回值包括以下状态代码。

返回值	说明
STATUS_INVALID_PARAMETER	不是有效的句柄值。
STATUS_UNSUCCESSFUL	此设备没有 PEP。

此例程由故障转储设备的驱动程序调用，以通知 PoFx 该设备是故障转储设备链的一部分。 ) (存储控制器、PCI 控制器等的多个设备可能需要打开，以便 Windows 内核可以将故障转储文件写入磁盘。发生致命的系统错误时，内核会尝试打开故障转储设备并保存故障转储文件。

在调用 PoFxRegisterCrashdumpDevice 之前，驱动程序必须调用 PoFxRegisterDevice 以将设备注册到 PoFx。

故障转储设备的驱动程序可以调用 PoFxPowerOnCrashdumpDevice 例程，以请求 PEP 打开设备。

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

PoFxRegisterCrashdumpDevice 必须在 IRQL = PASSIVE_LEVEL调用。