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

  • Статья

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

Синтаксис

NDIS_STATUS NdisQueryAdapterInstanceName(
       PNDIS_STRING pAdapterInstanceName,
  [in] NDIS_HANDLE  NdisBindingHandle
);

Параметры

pAdapterInstanceName

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

[in] NdisBindingHandle

Дескриптор, определяющий привязку к целевому физическому сетевому адаптеру или виртуальному адаптеру следующего ниже драйвера, к которому привязан вызывающий объект. Как правило, функция NdisOpenAdapterEx возвращала NdisBindingHandle.

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

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

Комментарии

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

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

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

Требования

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

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

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING