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

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

Синтаксис

NTSTATUS PoFxRegisterCrashdumpDevice(
  POHANDLE Handle
);

Параметры

Handle

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

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

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

Комментарии

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

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

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

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

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

Требования

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

PoFxPowerOnCrashdumpDevice

PoFxRegisterDevice