Функция 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. Возможные значения возвращаемых ошибок включают следующие коды состояния.

Замечания

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

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

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

Требования

См. также

PO_FX_CORE_DEVICE

UNICODE_STRING