Функция 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
Дескриптор, определяющий привязку к целевому физическому сетевому адаптеру или виртуальному адаптеру следующего драйвера, к которому привязан вызывающий объект. Как правило, NdisBindingHandle возвращается функцией NdisOpenAdapterEx.
Возвращаемое значение
NdisQueryAdapterInstanceName возвращает NDIS_STATUS_SUCCESS, если память строки на AdapterInstanceName была успешно выделена; в противном случае возвращается NDIS_STATUS_RESOURCES.
Замечания
Драйвер протокола использует NdisQueryAdapterInstanceName для получения понятного имени физического сетевого адаптера или виртуального адаптера, к которому привязан драйвер протокола. Драйвер протокола указывает дескриптор такого сетевого адаптера или виртуального адаптера в NdisBindingHandle. Драйвер протокола вызывает функцию NdisOpenAdapterEx для получения этого дескриптора.
NdisQueryAdapterInstanceName выделяет память для строки, указывающей понятное имя. После завершения вызова этой памяти вызывающий объект должен вызвать функцию NdisFreeMemory, чтобы освободить память.
Понятные имена предназначены для быстрого и точного определения физического сетевого адаптера или виртуального адаптера, например "АДАПТЕР PCI Ethernet" и "Виртуальный частный сетевой адаптер" считаются понятными именами.