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


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

Подпрограмма poFxRegisterPluginEx регистрирует подключаемый модуль расширения платформы (PEP) с платформой платформы управления питанием (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
Для версии или размера элемента структуры PEP_KERNEL_INFORMATION задано недопустимое значение; или AcceptDeviceNotification член этой структуры имеет значение NULL.
STATUS_INVALID_PEP_INFO_VERSION
Элемент версии структуры PEP_INFORMATION имеет недопустимое значение.
STATUS_INSUFFICIENT_RESOURCES
Не удалось выделить ресурсы, необходимые для завершения запрошенной регистрации.

Замечания

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

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

Подпрограмма PoFxRegisterPlugin похожа на PoFxRegisterPluginEx, за исключением того, что она не принимает параметр Флаги.

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно начиная с Windows 10.
целевая платформа Виндоус
заголовка pep_x.h (include Pep_x.h)
библиотеки Ntoskrnl.lib
IRQL PASSIVE_LEVEL

См. также

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin