Функция NdisMQueryAdapterInstanceName (ndis.h)
Функция NdisMQueryAdapterInstanceName извлекает понятное имя адаптера мини-порта.
Синтаксис
NDIS_STATUS NdisMQueryAdapterInstanceName(
PNDIS_STRING pAdapterInstanceName,
NDIS_HANDLE MiniportHandle
);
Параметры
pAdapterInstanceName
Указатель на предоставленный вызывающим NDIS_STRING типом, который получает подсчитываемую строку Юникода. Эта строка задает понятное имя интерфейса для заданного адаптера мини-порта. Для Windows Vista и более поздних версий операционной системы Windows NDIS определяет тип NDIS_STRING как тип UNICODE_STRING .
MiniportHandle
Дескриптор адаптера miniport, который ранее входил в Функция MiniportInitializeEx .
Возвращаемое значение
Возвращает NDIS_STATUS_SUCCESS, если память для строки в AdapterInstanceName была успешно выделена; в противном случае возвращается NDIS_STATUS_RESOURCES.
Комментарии
Драйвер мини-порта использует NdisMQueryAdapterInstanceName для получения понятного имени интерфейса, которым управляет драйвер минипорта. Этот интерфейс является физическим сетевым адаптером или виртуальным адаптером и называется адаптером мини-порта. Драйвер мини-порта указывает дескриптор адаптера мини-порта в MiniportAdapterHandle . Этот дескриптор адаптеру miniport передается в функцию MiniportInitializeEx драйвера минипорта, чтобы настроить адаптер miniport для операций сетевого ввода-вывода.
NdisMQueryAdapterInstanceName выделяет память для строки, указывающей понятное имя. После того как вызывающий объект завершит использование этой памяти, вызывающий объект должен вызвать функцию NdisFreeMemory , чтобы освободить память.
Понятные имена помогают пользователю быстро и точно идентифицировать физический сетевой адаптер или виртуальный адаптер. Например, "АДАПТЕР ETHERNET PCI" и "Виртуальный частный сетевой адаптер" считаются понятными именами.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается в NDIS 5.1 и NDIS 6.0 и более поздних версиях. Драйверы NDIS 5.1 см. в разделе NdisMQueryAdapterInstanceName (NDIS 5.1). |
| Целевая платформа | Универсальное |
| Верхняя часть | ndis.h (включая Ndis.h) |
| Библиотека | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Правила соответствия DDI | Irql_Miniport_Driver_Function(ndis) |