функция обратного вызова MINIPORT_ENABLE_INTERRUPT (ndis.h)

Статья
08/07/2023

NDIS может вызывать обработчик MiniportEnableInterruptEx драйвера miniport , чтобы включить прерывания для диагностики и устранения неполадок.

Примечание Функцию необходимо объявить с помощью типа MINIPORT_ENABLE_INTERRUPT . Дополнительные сведения см. в следующем разделе Примеры.

Синтаксис

MINIPORT_ENABLE_INTERRUPT MiniportEnableInterrupt;

void MiniportEnableInterrupt(
  [in] NDIS_HANDLE MiniportInterruptContext
)
{...}

Параметры

[in] MiniportInterruptContext

Дескриптор для блока контекстных сведений. Драйвер мини-порта предоставил этот дескриптор в параметре MiniportInterruptContext , который драйвер мини-порта передал вФункция NdisMRegisterInterruptEx.

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

None

Remarks

Драйвер мини-порта должен предоставить обработчик MiniportEnableInterruptEx , если драйвер вызывает функцию NdisMRegisterInterruptEx для регистрации прерывания.

Драйверы miniport должны отключать и включать прерывания, как описано на страницах справочника MiniportInterrupt и MiniportInterruptDpc .

NDIS вызывает MiniportEnableInterruptEx иФункции MiniportDisableInterruptEx для включения и отключения прерываний в целях диагностики и устранения неполадок. Как правило, MiniportEnableInterruptEx и MiniportDisableInterruptEx обращаются к ресурсам драйверов мини-портов, которые совместно используются функцией MiniportInterrupt . Поэтому NDIS вызывает эти обработчики в DIRQL.

Примеры

Чтобы определить функцию MiniportEnableInterruptEx , необходимо сначала предоставить объявление функции, определяющее тип определяемой функции. Windows предоставляет набор типов функций для драйверов. Объявление функции с помощью типов функций помогает анализу кода для драйверов, средству проверки статических драйверов (SDV) и другим средствам проверки находить ошибки, и это требование для написания драйверов для операционной системы Windows.

Например, чтобы определить функцию MiniportEnableInterruptEx с именем MyEnableInterruptEx, используйте тип MINIPORT_ENABLE_INTERRUPT , как показано в следующем примере кода:

MINIPORT_ENABLE_INTERRUPT MyEnableInterruptEx;

Затем реализуйте функцию следующим образом:

_Use_decl_annotations_
VOID
 MyEnableInterruptEx(
    NDIS_HANDLE  MiniportInterruptContext
    )
  {...}

Тип функции MINIPORT_ENABLE_INTERRUPT определен в файле заголовка Ndis.h. Чтобы более точно определить ошибки при запуске средств анализа кода, не забудьте добавить заметку Use_decl_annotations в определение функции. Заметка Use_decl_annotations гарантирует использование заметок, применяемых к типу функции MINIPORT_ENABLE_INTERRUPT в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в статье Объявление функций с помощью типов ролей функций для драйверов NDIS.

Сведения о Use_decl_annotations см. в статье Поведение функции с заметками.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа	Windows
Header	ndis.h (включая Ndis.h)
IRQL	См. раздел "Примечания"