Функция NdisQueryBindInstanceName (ndis.h)
Функция 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 (include Ndis.h) |
| библиотеки | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| правил соответствия DDI | NdisQueryBindInstanceName(ndis) |