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

Статья
08/07/2023

Функция 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, 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)