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