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

Статья
02/07/2025

Функция 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 не указывает порядок стека для промежуточных драйверов MUX.

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.0 и более поздних версиях.
целевая платформа	Настольный
заголовка	ndis.h (include Ndis.h)
библиотеки	Ndis.lib
IRQL	PASSIVE_LEVEL
правил соответствия DDI	Irql_Interfaces_Function(ndis)

См. также

NdisIfDeleteIfStackEntry

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