Функция 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. Возможные возвращаемые значения ошибок включают следующие коды состояния.
Возвращаемое значение | Описание |
---|---|
|
Для элемента Version или Size структуры PEP_KERNEL_INFORMATION задано недопустимое значение; или элемент AcceptDeviceNotification этой структуры имеет значение NULL. |
|
Для элемента Version структуры PEP_INFORMATION задано недопустимое значение. |
|
Не удалось выделить ресурсы, необходимые для завершения запрошенной регистрации. |
Комментарии
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 |