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

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

MiniportInitializeEx

NdisFreeMemory

UNICODE_STRING