Функция 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 возвращает одно из следующих значений состояния:
| Код возврата | Описание |
|---|---|
|
Операция выполнена успешно. |
|
Ошибка 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) |