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

Статья
02/07/2025

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

Синтаксис

NDIS_STATUS NdisIfGetInterfaceIndexFromNetLuid(
  [in]  NET_LUID     NetLuid,
  [out] PNET_IFINDEX pIfIndex
);

Параметры

[in] NetLuid

Значение NET_LUID, определяющее сетевой интерфейс.

[out] pIfIndex

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

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

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

Возвращаемый код	Описание
NDIS_STATUS_SUCCESS	Операция успешно завершена.
NDIS_STATUS_INTERFACE_NOT_FOUND	сбой NdisIfGetInterfaceIndexFromNetLuid, так как указанный NET_LUID отсутствует в списке зарегистрированных интерфейсов.

Замечания

Драйверы NDIS могут вызывать функцию NdisIfGetInterfaceIndexFromNetLuid, чтобы получить индекс сетевого интерфейса, связанный со значением 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 предоставляет функцию NdisIfGetNetLuidFromInterfaceIndex, чтобы получить значение NET_LUID, связанное с указанным индексом интерфейса.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.0 и более поздних версиях.
целевая платформа	Настольный
заголовка	ndis.h (include Ndis.h)
библиотеки	Ndis.lib
IRQL	PASSIVE_LEVEL
правил соответствия DDI	Irql_Interfaces_Function(ndis)