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

Статья
02/27/2024

Подпрограмма PoFxPowerOnCrashdumpDevice запрашивает включение устройства аварийного дампа.

Синтаксис

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

Параметры

[in] Handle

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

[in, optional] Context

Указатель на контекст устройства. Этот указатель передается в качестве входного параметра в процедуру обратного вызова PowerOnDumpDeviceCallback , реализованную подключаемым модулем расширения платформы (PEP) для устройства. Сведения о контексте хранятся в формате, определенном драйвером устройства и распознаваемом PEP. Этот контекст непрозрачн для операционной системы. Драйвер может задать для этого параметра значение NULL, если для PEP не требуется контекст.

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

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

Возвращаемое значение	Описание
STATUS_INVALID_PARAMETER	Недопустимое значение дескриптора.
STATUS_UNSUCCESSFUL	PEP для этого устройства не реализует подпрограмму обратного вызова PowerOnDumpDeviceCallback ; или pep не удалось включить устройство.

Драйвер для устройства аварийного дампа вызывает эту подпрограмму, чтобы запросить включение устройства с помощью подключаемого модуля расширения платформы (PEP) для сохранения аварийного дампа. Все устройства в цепочке устройств аварийного дампа (которые могут включать контроллер хранилища, контроллер PCI и т. д.) должны быть включены, прежде чем файл аварийного дампа можно будет записать на диск.

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

Эту подпрограмму можно вызвать по адресу IRQL <= HIGH_LEVEL.

Требования

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

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

PoFxRegisterDevice

PowerOnDumpDeviceCallback

Поделиться через