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


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

Функция NdisIfGetNetLuidFromInterfaceIndex получает значение NET_LUID , связанное с индексом сетевого интерфейса.

Синтаксис

NDIS_STATUS NdisIfGetNetLuidFromInterfaceIndex(
        NET_IFINDEX ifIndex,
  [out] PNET_LUID   pNetLuid
);

Параметры

ifIndex

Индекс сетевого интерфейса, назначенный NDIS NET_LUID значению вФункция NdisIfRegisterInterface.

[out] pNetLuid

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

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

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

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

Комментарии

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

Для интерфейсов, которыми управляет служба поставщика прокси-сервера NDIS, NDIS предоставляет индекс интерфейса и NET_LUID в различных структурах инициализации драйверов:

  • Драйверы минипорта могут получить индекс интерфейса и NET_LUID для адаптера мини-порта в NDIS_MINIPORT_INIT_PARAMETERS структура.
  • Драйверы фильтров могут получить индекс интерфейса и NET_LUID для модуля фильтрации в NDIS_FILTER_ATTACH_PARAMETERS структура.
  • Драйверы протокола могут получить индекс интерфейса и NET_LUID самого высокого и нижнего интерфейсов в стеке драйверов в структуре NDIS_BIND_PARAMETERS .
NDIS назначает индекс интерфейса сетевому интерфейсу, когда поставщик интерфейса вызывает функцию NdisIfRegisterInterface . Поставщик интерфейса вызывает макрос NDIS_MAKE_NET_LUID , чтобы создать значение NET_LUID перед регистрацией интерфейса.

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

NDIS предоставляетФункция NdisIfGetInterfaceIndexFromNetLuid для получения индекса интерфейса для указанного NET_LUID.

Требования

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

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

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MAKE_NET_LUID

NDIS_MINIPORT_INIT_PARAMETERS

NET_LUID

NdisIfGetInterfaceIndexFromNetLuid

NdisIfRegisterInterface