Функция PoFxRegisterPlugin (pep_x.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 pep_x.h (включая Pep_x.h)
Библиотека Ntoskrnl.lib
IRQL PASSIVE_LEVEL

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

PEP_INFORMATION

PEP_KERNEL_INFORMATION_STRUCT_V3

PoFxRegisterPluginEx