Функция WdfInterruptGetInfo (wdfinterrupt.h)

  • Статья

[Относится к KMDF и UMDF]

Метод WdfInterruptGetInfo извлекает сведения об указанном прерывании.

Синтаксис

void WdfInterruptGetInfo(
  [in]      WDFINTERRUPT        Interrupt,
  [in, out] PWDF_INTERRUPT_INFO Info
);

Параметры

[in] Interrupt

Дескриптор объекта прерывания.

[in, out] Info

Указатель на структуру WDF_INTERRUPT_INFO , выделенную вызывающим объектом, которая была инициализирована путем вызова WDF_INTERRUPT_INFO_INIT.

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

None

Remarks

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Метод WdfInterruptGetInfo может получить сведения о прерывании, только если драйвер вызывает его после того, как платформа вызвала функцию обратного вызова EvtDevicePrepareHardware драйвера и до того, как платформа вызвала функцию обратного вызова EvtDeviceReleaseHardware драйвера.

После возврата WdfInterruptGetInfo драйвер может определить объекты прерываний пассивного уровня, проверив член Irqlструктуры WDF_INTERRUPT_INFO . Для объектов прерывания пассивного уровня это значение равно PASSIVE_LEVEL.

Сведения о порядке вызова функций обратного вызова драйвера см. в статье Сценарии PnP и управления питанием.

Дополнительные сведения об обработке прерываний в драйверах на основе платформы см. в разделе Обработка аппаратных прерываний.

Примеры

В следующем примере кода инициализируется структура WDF_INTERRUPT_INFO и вызывается WdfInterruptGetInfo.

WDF_INTERRUPT_INFO  Info;

WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
                    Interrupt,
                    &Info
                    );

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfinterrupt.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf)

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

EvtDevicePrepareHardware

EvtDeviceReleaseHardware

WDF_INTERRUPT_INFO

WDF_INTERRUPT_INFO_INIT