Функция PoFxRegisterPluginEx (pep_x.h)

  • Статья

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

Синтаксис

NTSTATUS PoFxRegisterPluginEx(
  [in]      PPEP_INFORMATION        PepInformation,
  [in]      ULONGLONG               Flags,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

Параметры

[in] PepInformation

Указатель на структуру PEP_INFORMATION , содержащую указатели на одну или несколько процедур обратного вызова, реализованных PEP. Эти подпрограммы обрабатывают уведомления, отправляемые в PEP poFx.

[in] Flags

Набор битов флагов для настройки интерфейса PEP. Присвойте этому элементу значение ноль или следующее значение.

Бит флага Описание
PEP_FLAG_WORKER_CONCURRENCY

[in, out] KernelInformation

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

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

PoFxRegisterPluginEx возвращает 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 необходимо обслуживать, операционная система должна перезапуститься.

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

PeP должен вызывать PoFxRegisterPluginEx в IRQL = PASSIVE_LEVEL.

Требования

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

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

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin