Функция PoFxRegisterPlugin (pepfx.h)

  • Статья

Подпрограмма PoFxRegisterPlugin регистрирует подключаемый модуль расширения платформы (PEP) с платформой управления питанием Windows (PoFx).

Синтаксис

NTSTATUS PoFxRegisterPlugin(
  [in]      PPEP_INFORMATION        PepInformation,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

Параметры

[in] PepInformation

Указатель на структуру PEP_INFORMATION .

[in, out] KernelInformation

Указатель на структуру PEP_KERNEL_INFORMATION_STRUCT_V3 .

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

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

Возвращаемое значение Описание
STATUS_INVALID_PARAMETER Для элемента Version или Size структуры PEP_KERNEL_INFORMATION задано недопустимое значение; или для элемента AcceptDeviceNotification этой структуры задано значение NULL.
STATUS_INVALID_PEP_INFO_VERSION Для элемента Version структуры PEP_INFORMATION задано недопустимое значение.
STATUS_INSUFFICIENT_RESOURCES Не удалось выделить ресурсы, необходимые для завершения запрошенной регистрации.

Комментарии

PEP вызывает эту подпрограмму для регистрации в PoFx.

PeP не может отменить регистрацию и не может зарегистрировать дважды. Если pep необходимо обслуживать, операционная система должна перезапуститься.

Подпрограмма PoFxRegisterPluginEx аналогична процедуре PoFxRegisterPlugin, за исключением того, что она принимает дополнительный параметр Flags.

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

Требования

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

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

PEP_INFORMATION

PEP_KERNEL_INFORMATION_STRUCT_V3

PoFxRegisterPluginEx