Функция PoFxRegisterCrashdumpDevice (wdm.h)

Подпрограмма PoFxRegisterCrashdumpDevice регистрирует устройство аварийного дампа.

Синтаксис

NTSTATUS PoFxRegisterCrashdumpDevice(
  POHANDLE Handle
);

Параметры

Handle

Дескриптор, представляющий регистрацию устройства аварийного дампа с помощью платформы управления питанием Windows (PoFx). Драйвер устройства ранее получил этот дескриптор из подпрограммы PoFxRegisterDevice .

Возвращаемое значение

PoFxRegisterCrashdumpDevice возвращает STATUS_SUCCESS, если подпрограмма успешно регистрирует устройство аварийного дампа. Возможные возвращаемые значения ошибок включают следующие коды состояния.

Возвращаемое значение	Описание
STATUS_INVALID_PARAMETER	Недопустимое значение дескриптора.
STATUS_UNSUCCESSFUL	Для этого устройства отсутствует PEP.

Комментарии

Эта подпрограмма вызывается драйвером для устройства аварийного дампа, чтобы сообщить PoFx, что устройство является частью цепочки устройств аварийного дампа. Может потребоваться включить несколько устройств (контроллер хранения данных, контроллер PCI и т. д.), чтобы ядро Windows могло записать файл аварийного дампа на диск. При возникновении неустранимой системной ошибки ядро пытается включить устройства аварийного дампа и сохранить файл аварийного дампа.

Драйвер должен вызвать PoFxRegisterDevice , чтобы зарегистрировать устройство в PoFx перед вызовом PoFxRegisterCrashdumpDevice.

Драйвер для устройства аварийного дампа может вызвать подпрограмму PoFxPowerOnCrashdumpDevice , чтобы запросить включение устройства PEP.

Дополнительные сведения о аварийных дампах см. в разделе Файлы дампа в режиме ядра.

Метод PoFxRegisterCrashdumpDevice должен вызываться по адресу IRQL = PASSIVE_LEVEL.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.1.
Целевая платформа	Windows
Header	wdm.h (включая Pepfx.h)
Библиотека	Ntoskrnl.lib
IRQL	PASSIVE_LEVEL

См. также раздел

PoFxPowerOnCrashdumpDevice

PoFxRegisterDevice