структура 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
Сеть банкоматов. Драйверы клиентских протоколов, ориентированные на подключение, могут привязываться к базовому драйверу мини-порта, который возвращает это значение. В противном случае устаревшие драйверы протоколов привязываются к системному промежуточному драйверу 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 и POS.
NdisPhysicalMediumNative802_11
9
Пакеты передаются по беспроводной локальной сети через драйвер мини-порта, соответствующий интерфейсу Native 802.11.
Примечание. Собственный интерфейс 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
Пакеты передаются по широкой сети в среде, ориентированной на подключение.
NdisPhysicalMediumДруга
19
Пакеты передаются по сети, которая не описана другими возможными значениями.
AccessType
Тип доступа к сетевому интерфейсу NET_IF_ACCESS_TYPE NDIS.DirectionType
Тип направления сетевого интерфейса NET_IF_DIRECTION_TYPE NDIS.InterfaceAndOperStatusFlags
Набор следующих флагов, предоставляющих сведения об интерфейсе. Эти флаги объединяются с побитовой операцией OR. Если ни один из флагов не применяется, этому элементу присваивается нулевое значение.HardwareInterface
Сетевой интерфейс предназначен для оборудования.FilterInterface
Сетевой интерфейс предназначен для модуля фильтра.ConnectorPresent
Соединитель присутствует в сетевом интерфейсе. Это значение устанавливается при наличии физического сетевого адаптера.Без проверки подлинности
Порт по умолчанию для сетевого интерфейса не проходит проверку подлинности. Если сетевой интерфейс не проходит проверку подлинности в целевом объекте, сетевой интерфейс не находится в рабочем режиме. Хотя эта ситуация относится как к проводным, так и к беспроводным сетевым подключениям, проверка подлинности чаще применяется для беспроводных сетевых подключений.NotMediaConnected
Сетевой интерфейс не подключен к мультимедиа. Если сетевой кабель отключен для проводной сети, это значение устанавливается. Для беспроводной сети это значение устанавливается для сетевого адаптера, который не подключен к сети.Приостановлено
Сетевой стек для сетевого интерфейса находится в состоянии приостановки или приостановки. Это значение не означает, что компьютер находится в состоянии гибернации.LowPower
Сетевой интерфейс находится в состоянии низкого энергопотребления.EndPointInterface
Сетевой интерфейс является конечным устройством, а не истинным сетевым интерфейсом, который подключается к сети. Это значение может быть установлено устройствами, такими как смартфоны, которые используют сетевую инфраструктуру для связи с компьютером, но не обеспечивают подключение к внешней сети. Эти типы устройств должны установить этот флаг.
OperStatus
Тип рабочего состояния сетевого интерфейса IF_OPER_STATUS NDIS.AdminStatus
Тип административного состояния NET_IF_ADMIN_STATUS .MediaConnectState
Тип состояния подключения NET_IF_MEDIA_CONNECT_STATE .NetworkGuid
Guid, связанный с сетью, к которой принадлежит интерфейс.ConnectionType
Тип подключения сетевого интерфейса NET_IF_CONNECTION_TYPE NDIS.TransmitLinkSpeed
Скорость передачи канала передачи (в битах в секунду).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 (включая Netioapi.h) |