Функция 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" и "Виртуальный частный сетевой адаптер" считаются понятными именами.

Требования

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

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING