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

  • Статья

Функция NdisIfQueryBindingIfIndex извлекает индексы сетевых интерфейсов и NET_LUID значения для сетевых интерфейсов с наибольшим и наименьшим уровнем, связанными с указанной привязкой протокола.

Синтаксис

NDIS_STATUS NdisIfQueryBindingIfIndex(
  [in]  NDIS_HANDLE  NdisBindingHandle,
  [out] PNET_IFINDEX pBoundIfIndex,
  [out] PNET_LUID    pBoundIfNetLuid,
  [out] PNET_IFINDEX pLowestIfIndex,
  [out] PNET_LUID    pLowestIfNetLuid
);

Параметры

[in] NdisBindingHandle

Дескриптор, определяющий привязку, для которой NDIS должен получить значения NET_LUID и индексы сетевого интерфейса. NDIS предоставил этот дескриптор в параметре NdisBindingHandle функции NdisOpenAdapterEx .

[out] pBoundIfIndex

Указатель на переменную индекса интерфейса, предоставляемую вызывающим абонентом. Если NdisIfQueryBindingIfIndex выполняется успешно, NDIS записывает в эту переменную индекс сетевого интерфейса сетевого интерфейса, который связан с указанной привязкой и является самым высоким в стеке драйверов.

[out] pBoundIfNetLuid

Указатель на переменную, предоставленную вызывающим NET_LUID. Если NdisIfQueryBindingIfIndex выполняется успешно, NDIS записывает в эту переменную значение NET_LUID сетевого интерфейса, связанного с указанной привязкой и самого высокого значения в стеке драйверов.

[out] pLowestIfIndex

Указатель на переменную индекса интерфейса, предоставляемую вызывающим абонентом. Если NdisIfQueryBindingIfIndex выполняется успешно, NDIS записывает в эту переменную индекс сетевого интерфейса сетевого интерфейса, который связан с указанной привязкой и является самым низким в стеке драйверов.

[out] pLowestIfNetLuid

Указатель на переменную, предоставленную вызывающим NET_LUID. Если NdisIfQueryBindingIfIndex выполняется успешно, NDIS записывает в эту переменную значение NET_LUID сетевого интерфейса, связанного с указанной привязкой и самого низкого значения в стеке драйверов.

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

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

Код возврата Описание
NDIS_STATUS_SUCCESS
 Операция выполнена успешно.
NDIS_STATUS_INTERFACE_NOT_FOUND
 Ошибка NdisIfQueryBindingIfIndex , так как указанная привязка не связана с зарегистрированным интерфейсом.

Комментарии

Драйверы протокола NDIS могут вызывать функцию NdisIfQueryBindingIfIndex для получения индексов сетевого интерфейса и NET_LUID значений, связанных с привязкой.

NdisIfQueryBindingIfIndex предоставляет значение NET_LUID и индекс интерфейса для самого высокого и самого низкого интерфейса, связанных с привязкой. Эти значения различаются, например, если адаптер минипорта, непосредственно связанный с указанной привязкой, является виртуальным минипортом промежуточного драйвера фильтра или если для адаптера минипорта настроен модуль фильтра.

Драйверы протоколов также могут получить индекс интерфейса и NET_LUID интерфейсов самого высокого и самого низкого уровня в стеке драйверов в структуре NDIS_BIND_PARAMETERS .

Требования

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

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

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx