структура MIB_IF_ROW2
Структура MIB_IF_ROW2 хранит сведения о конкретном интерфейсе.
Синтаксис
typedef struct _MIB_IF_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
GUID InterfaceGuid;
WCHAR Alias[IF_MAX_STRING_SIZE + 1];
WCHAR Description[IF_MAX_STRING_SIZE + 1];
ULONG PhysicalAddressLength;
UCHAR PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
UCHAR PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
ULONG Mtu;
IFTYPE Type;
TUNNEL_TYPE TunnelType;
NDIS_MEDIUM MediaType;
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
struct {
BOOLEAN HardwareInterface :1;
BOOLEAN FilterInterface :1;
BOOLEAN ConnectorPresent :1;
BOOLEAN NotAuthenticated :1;
BOOLEAN NotMediaConnected :1;
BOOLEAN Paused :1;
BOOLEAN LowPower :1;
BOOLEAN EndPointInterface :1;
} InterfaceAndOperStatusFlags;
IF_OPER_STATUS OperStatus;
NET_IF_ADMIN_STATUS AdminStatus;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_NETWORK_GUID NetworkGuid;
NET_IF_CONNECTION_TYPE ConnectionType;
ULONG64 TransmitLinkSpeed;
ULONG64 ReceiveLinkSpeed;
ULONG64 InOctets;
ULONG64 InUcastPkts;
ULONG64 InNUcastPkts;
ULONG64 InDiscards;
ULONG64 InErrors;
ULONG64 InUnknownProtos;
ULONG64 InUcastOctets;
ULONG64 InMulticastOctets;
ULONG64 InBroadcastOctets;
ULONG64 OutOctets;
ULONG64 OutUcastPkts;
ULONG64 OutNUcastPkts;
ULONG64 OutDiscards;
ULONG64 OutErrors;
ULONG64 OutUcastOctets;
ULONG64 OutMulticastOctets;
ULONG64 OutBroadcastOctets;
ULONG64 OutQLen;
} MIB_IF_ROW2, *PMIB_IF_ROW2;
Члены
InterfaceLuid
Локальный уникальный идентификатор (LUID) для сетевого интерфейса.InterfaceIndex
Индекс, определяющий сетевой интерфейс. Это значение индекса может измениться, если сетевой адаптер отключен, а затем включен и не должен считаться постоянным.InterfaceGuid
GUID сетевого интерфейса.Псевдоним
Строка Юникода с завершением NULL, содержащая псевдоним сетевого интерфейса.описание
Строка Юникода с завершением NULL, содержащая описание сетевого интерфейса.PhysicalAddressLength
Длина в байтах физического аппаратного адреса, указанного членом PhysicalAddress.PhysicalAddress
Физический аппаратный адрес адаптера для этого сетевого интерфейса.PermanentPhysicalAddress
Постоянный физический аппаратный адрес адаптера для этого сетевого интерфейса.Mtu
Максимальный размер единицы передачи (MTU) в байтах для этого сетевого интерфейса.типа
Тип интерфейса, определенный центром назначенных Интернетом имен (IANA). Дополнительные сведения см. в разделе IANAifType-MIB DEFINITIONS. Возможные значения для типа интерфейса перечислены в файле заголовка Ipifcons.h.В следующей таблице перечислены распространенные значения для типа интерфейса, хотя возможны многие другие значения.
Ценность Значение IF_TYPE_OTHER
1
Другой тип сетевого интерфейса
IF_TYPE_ETHERNET_CSMACD
6
Сетевой интерфейс Ethernet
IF_TYPE_ISO88025_TOKENRING
9
Сетевой интерфейс кольца токенов
IF_TYPE_PPP
23
Сетевой интерфейс PPP
IF_TYPE_SOFTWARE_LOOPBACK
24
Сетевой интерфейс программного цикла
IF_TYPE_ATM
37
Сетевой интерфейс ATM
IF_TYPE_IEEE80211
71
Беспроводной сетевой интерфейс IEEE 802.11
IF_TYPE_TUNNEL
131
Сетевой интерфейс типа туннеля инкапсуляции
IF_TYPE_IEEE1394
144
Сетевой интерфейс последовательной шины IEEE 1394 (Firewire) с высокой производительностью
TunnelType
Если элемент Type IF_TYPE_TUNNEL, тип TUNNEL_TYPE, определяющий метод инкапсуляции, который использует туннель.MediaType
Тип носителя NDIS для интерфейса. Этот элемент может быть одним из следующих значений из типа перечисления NDIS_MEDIUM, определенного в файле заголовка Ntddndis.h.Ценность Значение NdisMedium802_3
0
Сеть Ethernet (802.3).
NdisMedium802_5
1
Сеть "Кольцо маркера" (802.5).
NdisMediumFddi
2
Сеть распределенного интерфейса данных (FDDI).
NdisMediumWan
3
Широкая сеть (глобальная сеть). Этот тип охватывает различные формы сетевых адаптеров типа "точка — точка — точка" и сетевые адаптеры глобальной сети и форматы адресов и заголовков вариантов, которые должны быть согласованы между драйвером протокола и базовым драйвером после установки привязки.
NdisMediumLocalTalk
4
Сеть LocalTalk.
NdisMediumDix
5
Сеть Ethernet, для которой драйверы используют формат заголовка DIX Ethernet.
NdisMediumArcnetRaw
6
Сеть ARCNET.
NdisMediumArcnet878_2
7
Сеть ARCNET (878.2).
NdisMediumAtm
8
Сеть ATM. Драйверы клиентского протокола, ориентированные на подключение, могут привязать себя к базовому драйверу минипорта, который возвращает это значение. В противном случае устаревшие драйверы протокола привязываются к предоставленному системой промежуточному драйверу LanE, который сообщает о своем среднем типе как NdisMedium802_3 или NdisMedium802_5, в зависимости от того, как администратор сети настраивает драйвер LanE.
NdisMediumWirelessWan
9
Беспроводной сети. NDIS 5. X мини-драйверы, поддерживающие беспроводные локальные сети (WLAN) или беспроводные пакеты глобальной сети (WWAN), объявляют их среду как NdisMedium802_3 и эмулируют Ethernet на более высокий уровень драйверов NDIS.
Обратите внимание, что этот тип носителя недоступен для использования в Windows Vista или более поздних версиях Windows.
NdisMediumIrda
10
Инфракрасная сеть (IrDA).
NdisMediumBpc
11
Сеть широковещательного компьютера.
NdisMediumCoWan
12
Широкая сеть в среде, ориентированной на подключение.
NdisMedium1394
13
Сеть IEEE 1394 (пожарная проводная сеть).
NdisMediumInfiniBand
14
Сеть InfiniBand.
NdisMediumTunnel
15
Сеть туннеля.
NdisMediumNative802_11
16
Собственная сеть IEEE 802.11.
NdisMediumLoopback
17
Сеть обратного цикла NDIS.
PhysicalMediumType
Физический средний тип NDIS. Этот элемент может быть одним из следующих значений из типа перечисления NDIS_PHYSICAL_MEDIUM, определенного в файле заголовка Ntddndis.h.Ценность Значение NdisPhysicalMediumUnspecified
0
Физический носитель не имеет следующих значений. Например, односторонний вспомогательный канал представляет собой неуказанный физический носитель.
NdisPhysicalMediumWirelessLan
1
Пакеты передаются по беспроводной локальной сети через мини-драйвер, соответствующий интерфейсу 802.11.
NdisPhysicalMediumCableModem
2
Пакеты передаются через кабельную сеть на основе DOCSIS.
NdisPhysicalMediumPhoneLine
3
Пакеты передаются по стандартным телефонным линиям. Этот тип включает носитель HomePNA.
NdisPhysicalMediumPowerLine
4
Пакеты передаются через проводку, подключенную к системе распределения питания.
NdisPhysicalMediumDSL
5
Пакеты передаются по сети цифровой абонентской линии (DSL). Этот тип включает ADSL, UADSL (G.Lite) и SDSL.
NdisPhysicalMediumFibreChannel
6
Пакеты передаются через соединение Fibre Channel.
NdisPhysicalMedium1394
7
Пакеты передаются через шину IEEE 1394.
NdisPhysicalMediumWirelessWan
8
Пакеты передаются по беспроводной глобальной сети. Этот тип включает CDPD, CDMA и JSON.
NdisPhysicalMediumNative802_11
9
Пакеты передаются по беспроводной локальной сети через мини-драйвер, соответствующий интерфейсу Native 802.11.
Обратите внимание, что интерфейс Native 802.11 поддерживается в NDIS 6.0 и более поздних версиях.
NdisPhysicalMediumBluetooth
10
Пакеты передаются по сети Bluetooth. Bluetooth — это технология беспроводной связи с коротким диапазоном, использующая спектр 2,4 ГГц.
NdisPhysicalMediumInfiniband
11
Пакеты передаются через межсоединение InfiniBand.
NdisPhysicalMediumUWB
13
Пакеты передаются через сеть ультра широкой полосы.
NdisPhysicalMedium802_3
14
Пакеты передаются по сети Ethernet (802.3).
NdisPhysicalMedium802_5
15
Пакеты передаются по сети 802.5.
NdisPhysicalMediumIrda
16
Пакеты передаются через инфракрасную сеть (IrDA).
NdisPhysicalMediumWiredWAN
17
Пакеты передаются по проводной сети глобальной сети.
NdisPhysicalMediumWiredCoWan
18
Пакеты передаются по широкой сети в среде, ориентированной на подключение.
NdisPhysicalMediumOther
19
Пакеты передаются по сети, которая не описана другими возможными значениями.
AccessType
Тип доступа к сетевому интерфейсу NDIS NET_IF_ACCESS_TYPE.DirectionType
Тип направления сетевого интерфейса NDIS NET_IF_DIRECTION_TYPE.InterfaceAndOperStatusFlags
Набор следующих флагов, которые предоставляют сведения об интерфейсе. Эти флаги объединяются с побитовой операцией OR. Если ни один из флагов не применяется, этот элемент имеет значение нулю.HardwareInterface
Сетевой интерфейс предназначен для оборудования.FilterInterface
Сетевой интерфейс предназначен для модуля фильтра.ConnectorPresent
Соединитель присутствует в сетевом интерфейсе. Это значение задается, если существует физический сетевой адаптер.NotAuthenticated
Порт по умолчанию для сетевого интерфейса не проходит проверку подлинности. Если сетевой интерфейс не проходит проверку подлинности в целевом объекте, сетевой интерфейс не находится в рабочем режиме. Хотя эта ситуация относится как к проводным, так и к беспроводным сетевым подключениям, проверка подлинности более распространена для беспроводных сетевых подключений.NotMediaConnected
Сетевой интерфейс не находится в состоянии, подключенном к мультимедиа. Если сетевой кабель отключен для проводной сети, это значение устанавливается. Для беспроводной сети это значение задается для сетевого адаптера, который не подключен к сети.Приостановлено
Сетевой стек для сетевого интерфейса находится в состоянии приостановки или приостановки. Это значение не означает, что компьютер находится в состоянии гибернации.LowPower
Сетевой интерфейс находится в состоянии низкой мощности.EndPointInterface
Сетевой интерфейс — это устройство конечной точки, а не истинный сетевой интерфейс, который подключается к сети. Это значение можно задать устройствами, такими как смартфоны, которые используют сетевую инфраструктуру для обмена данными с компьютером, но не обеспечивают подключение к внешней сети. Эти типы устройств должны задать этот флаг.
OperStatus
Тип операционного состояния сетевого интерфейса NDIS IF_OPER_STATUS.AdminStatus
Тип NET_IF_ADMIN_STATUS административного состояния.MediaConnectState
Тип состояния подключения NET_IF_MEDIA_CONNECT_STATE.NetworkGuid
GUID, связанный с сетью, к которой принадлежит интерфейс.ConnectionType
Тип подключения сетевого интерфейса NDIS NET_IF_CONNECTION_TYPE.ПередачаLinkSpeed
Скорость передачи в битах в секунду.ReceiveLinkSpeed
Скорость передачи в битах в секунду.InOctets
Количество октетов данных, полученных без ошибок через этот интерфейс. Это значение включает в себя октеты в одноадресных, широковещательных и многоадресных пакетах.InUcastPkts
Количество одноадресных пакетов, полученных без ошибок через этот интерфейс.InNUcastPkts
Количество неадресных пакетов, полученных без ошибок через этот интерфейс. Это значение включает широковещательные и многоадресные пакеты.InDiscards
Количество входящих пакетов, которые были отменены, даже если они не имели ошибок.InErrors
Количество входящих пакетов, которые были отменены из-за ошибок.InUnknownProtos
Количество входящих пакетов, которые были отменены, так как протокол был неизвестен.InUcastOctets
Количество октетов данных, полученных без ошибок в одноадресных пакетах через этот интерфейс.InMulticastOctets
Количество октетов данных, полученных без ошибок в пакетах многоадресной рассылки через этот интерфейс.InBroadcastOctets
Количество октетов данных, полученных без ошибок в широковещательных пакетах через этот интерфейс.OutOctets
Количество октетов данных, передаваемых без ошибок через этот интерфейс. Это значение включает в себя октеты в одноадресных, широковещательных и многоадресных пакетах.OutUcastPkts
Количество одноадресных пакетов, передаваемых без ошибок через этот интерфейс.OutNUcastPkts
Число неадресных пакетов, передаваемых без ошибок через этот интерфейс. Это значение включает широковещательные и многоадресные пакеты.OutDiscards
Количество исходящих пакетов, которые были отменены, даже если они не имели ошибок.OutErrors
Количество исходящих пакетов, которые были удалены из-за ошибок.OutUcastOctets
Количество октетов данных, передаваемых без ошибок в одноадресных пакетах через этот интерфейс.OutMulticastOctets
Количество октетов данных, передаваемых без ошибок в многоадресных пакетах через этот интерфейс.OutBroadcastOctets
Количество октетов данных, передаваемых без ошибок в широковещательных пакетах через этот интерфейс.OutQLen
Длина очереди передачи. Это поле сейчас не используется.
Замечания
Значения поля Type определяются в файле заголовка Ipifcons.h. В настоящее время поддерживаются только возможные значения, перечисленные в описании элемента Type.
Требования
Версия |
Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
Заголовок |
Netioapi.h (include Netioapi.h) |