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

Статья
02/29/2024

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

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

Синтаксис

MINIPORT_DISABLE_INTERRUPT MiniportDisableInterrupt;

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

Параметры

[in] MiniportInterruptContext

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

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

None

Remarks

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

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

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

Примеры

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

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

MINIPORT_DISABLE_INTERRUPT MyDisableInterruptEx;

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

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

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

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

Требования

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