Функция NdisIfAddIfStackEntry (ndis.h)

  • Статья

Функция NdisIfAddIfStackEntry определяет порядок двух сетевых интерфейсов в стеке сетевых интерфейсов NDIS.

Синтаксис

NDIS_STATUS NdisIfAddIfStackEntry(
  [in] NET_IFINDEX HigherLayerIfIndex,
  [in] NET_IFINDEX LowerLayerIfIndex
);

Параметры

[in] HigherLayerIfIndex

Индекс сетевого интерфейса для интерфейса, который должен быть выше в таблице стека интерфейсов.

[in] LowerLayerIfIndex

Индекс сетевого интерфейса для интерфейса, который должен быть ниже в таблице стека интерфейсов.

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

NdisIfAddIfStackEntry возвращает одно из следующих значений состояния:

Код возврата Описание
NDIS_STATUS_SUCCESS
 Операция выполнена успешно.
NDIS_STATUS_RESOURCES
 Операция завершилась сбоем из-за нехватки ресурсов.
NDIS_STATUS_INTERFACE_NOT_FOUND
 Ошибка NdisIfAddIfStackEntry , так как индекс в HigherLayerIfIndex или LowerLayerIfIndex не является индексом зарегистрированного интерфейса.

Комментарии

Драйверы NDIS могут вызывать функцию NdisIfAddIfStackEntry , чтобы указать порядок двух сетевых интерфейсов в стеке интерфейсов NDIS. Поставщик прокси-сервера NDIS указывает порядок для модулей фильтрации и адаптеров минипорта. NDIS также указывает связь между виртуальным минипортом и базовым адаптером мини-порта для фильтров промежуточных драйверов. Однако NDIS не указывает порядок стека для промежуточных драйверов МУЛЬТИП.

NDIS поддерживает таблицу стека интерфейса (ifStackTable из RFC 2863). NDIS предоставляет NdisIfAddIfStackEntry и Функции NdisIfDeleteIfStackEntry для добавления и удаления записей в этой таблице.

Любой драйвер, который может предоставить сведения о связи порядка стека между двумя интерфейсами, должен вызывать NdisIfAddIfStackEntry для заполнения таблицы стека интерфейсов. NDIS удаляет соответствующие записи стека для интерфейса при отмене регистрации интерфейса.

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Верхняя часть ndis.h (включая Ndis.h)
Библиотека Ndis.lib
IRQL PASSIVE_LEVEL
Правила соответствия DDI Irql_Interfaces_Function(ndis)

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

NdisIfDeleteIfStackEntry