Функция 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 (include Ndis.h)
библиотеки	Ndis.lib
IRQL	PASSIVE_LEVEL
правил соответствия DDI	Irql_Interfaces_Function(ndis)

См. также

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx