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

  • Статья

Подпрограмма PoFxRegisterCoreDevice регистрирует новый основной системный ресурс с помощью платформы управления питанием Windows (PoFx).

Синтаксис

NTSTATUS PoFxRegisterCoreDevice(
  [in]  PCUNICODE_STRING   Id,
  [in]  PPO_FX_CORE_DEVICE Device,
  [out] POHANDLE           *Handle
);

Параметры

[in] Id

Строка, однозначно идентифицирующая основной системный ресурс. Этот элемент является указателем на структуру UNICODE_STRING , содержащую строку идентификации устройства.

[in] Device

Указатель на структуру PO_FX_CORE_DEVICE , которая описывает характеристики мощности основного системного ресурса.

[out] Handle

Указатель на расположение, в которое подпрограмма записывает значение POHANDLE. Этот дескриптор представляет регистрацию основного системного ресурса с помощью PoFx.

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

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

Возвращаемое значение Описание
STATUS_INVALID_PARAMETER
 Число компонентов для этого устройства равно нулю, структура PO_FX_CORE_DEVICE содержит недопустимый номер версии или элемент ComponentCriticalTransitionCallback этой структуры содержит недопустимый указатель функции.
STATUS_INSUFFICIENT_RESOURCES
 Не удалось выделить ресурсы, необходимые для завершения запрошенной регистрации.

Комментарии

Эта подпрограмма регистрирует основной системный ресурс, чтобы этот ресурс можно было управлять питанием с помощью PoFx.

Основные системные ресурсы — это аппаратные устройства, такие как таймеры и контроллеры прерываний, которые управляются уровнем аппаратной абстракции Windows (HAL). Эти устройства предоставляют базовые функции, необходимые операционной системе. Из-за тесной связи между основными системными ресурсами и процессорами управление питанием этих ресурсов должно быть согласовано с управлением состоянием простоя процессора.

Подпрограмма PoFxRegisterCoreDevice должна вызываться по адресу IRQL = PASSIVE_LEVEL.

Требования

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

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

PO_FX_CORE_DEVICE

UNICODE_STRING