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

Статья
02/29/2024

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