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

Статья
08/07/2023

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

Синтаксис

NDIS_STATUS NdisQueryBindInstanceName(
  [out] PNDIS_STRING pAdapterInstanceName,
  [in]  NDIS_HANDLE  BindingContext
);

Параметры

[out] pAdapterInstanceName

Указатель на тип NDIS_STRING, предоставленный вызывающим, который получает подсчитываемую строку Юникода. Эта строка задает понятное имя интерфейса, на который ссылается привязка. Это либо физический сетевой адаптер, либо виртуальный адаптер. Для операционных систем Microsoft Windows 2000 и более поздних версий NDIS определяет тип NDIS_STRING как тип UNICODE_STRING .

[in] BindingContext

Дескриптор, определяющий область контекста NDIS для операции привязки. NDIS передал этот дескриптор параметру BindContext Функция ProtocolBindAdapterEx .

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

NdisQueryBindInstanceName возвращает NDIS_STATUS_SUCCESS, если память для строки pAdapterInstanceName была успешно выделена; В противном случае возвращается NDIS_STATUS_RESOURCES.

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

Драйверы протоколов могут использовать NdisQueryBindInstanceName для получения понятного имени перед привязкой к адаптеру.

NdisQueryBindInstanceName выделяет память для строки, указывающей понятное имя. После того как вызывающий объект завершит использование этой памяти, вызывающий объект должен вызвать функцию NdisFreeMemory , чтобы освободить память.

Понятные имена помогают пользователю быстро и точно определить физический сетевой адаптер или виртуальный адаптер. Например, "АДАПТЕР PCI Ethernet" и "Виртуальный частный сетевой адаптер" считаются понятными именами.

Требования

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

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

NdisFreeMemory

ProtocolBindAdapterEx

UNICODE_STRING

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