Функция 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) |