Функция обратного вызова POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS (pep_x.h)

Статья
02/07/2025

В EnumerateUnmaskedInterrupts подпрограмма перечисляет источники прерываний, прерывания которых распаковываются и включены.

Синтаксис

POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS Pofxcallbackenumerateunmaskedinterrupts;

NTSTATUS Pofxcallbackenumerateunmaskedinterrupts(
  [in, optional] POHANDLE PluginHandle,
  [in, optional] ULONG EnumerateFlags,
  [in]           PPO_ENUMERATE_INTERRUPT_SOURCE_CALLBACK Callback,
  [in]           PVOID CallbackContext,
  [in, out]      PPEP_UNMASKED_INTERRUPT_INFORMATION InterruptInformation
)
{...}

Параметры

[in, optional] PluginHandle

Значение POHANDLE. Если значение не равно NULL, этот параметр является дескриптором, определяющим подключаемый модуль расширения платформы (PEP), в этом случае EnumerateUnmaskedInterrupts перечисляет только прерывания, управляемые этим PEP. Если этот параметр имеет значение NULL, EnumerateUnmaskedInterrupts перечисляет все прерывания на аппаратной платформе, которые не маскируются и включены.

[in, optional] EnumerateFlags

В настоящее время флаги не определены. Задайте для этого параметра значение PEP_ENUMERATE_UNMASKED_INTERRUPT_FLAGS_NONE (0x0).

[in] Callback

Указатель на подпрограмму обратного вызова, реализованного вызывающим EnumerateInterruptSource. Эта подпрограмма обратного вызова вызывается один раз для каждого источника прерывания, прерывание которого раскачено. Эти обратные вызовы выполняются синхронно до возврата подпрограммы перечисления EnumerateUnmaskedInterrup ts.

[in] CallbackContext

Указатель на контекст обратного вызова. Этот указатель передается в качестве параметра в подпрограмму обратного вызова EnumerateInterruptSource, на которую указывает параметр обратного вызова . Содержимое контекста обратного вызова определяется peP и непрозрачно к платформе управления питанием (PoFx).

[in, out] InterruptInformation

Указатель на выделенный вызывающим буфером, размер которого не менее размер(PEP_UNMASKED_INTERRUPT_INFORMATION) байтов. ПеречислениеUnmaskedInterrupts будет использовать этот буфер для передачи сведений о прерываниях в PEP во время вызовов перечисления ПеречисленияInterruptSource обратного вызова.

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

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

Возвращаемое значение	Описание
STATUS_INVALID_PARAMETER	размер или версии в структуре PEP_UNMASKED_INTERRUPT_INFORMATION содержит недопустимое значение.

Замечания

Эта подпрограмма реализуется PoFx и вызывается PEP. Элемент EnumerateUnmaskedInterrupts структуры PEP_KERNEL_INFORMATION_STRUCT_V3 является указателем на подпрограмму EnumerateUnmaskedInterrupts.

Перед тем как платформа входит в системное состояние питания, в котором контроллеры прерываний включены в систему, PEP может вызывать ПеречислитьUnmaskedInterrupts, чтобы получить сведения, необходимые для правильной настройки контроллеров пробуждения для прерываний, которые должны оставаться незамеченными.

PEP может вызывать эту подпрограмму в IRQL <= HIGH_LEVEL.

Требования

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

См. также

EnumerateInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION

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