структура MIB_IFROW (ifmib.h)
В структуре MIB_IFROW хранятся сведения об определенном интерфейсе.
Синтаксис
typedef struct _MIB_IFROW {
WCHAR wszName[MAX_INTERFACE_NAME_LEN];
IF_INDEX dwIndex;
IFTYPE dwType;
DWORD dwMtu;
DWORD dwSpeed;
DWORD dwPhysAddrLen;
UCHAR bPhysAddr[MAXLEN_PHYSADDR];
DWORD dwAdminStatus;
INTERNAL_IF_OPER_STATUS dwOperStatus;
DWORD dwLastChange;
DWORD dwInOctets;
DWORD dwInUcastPkts;
DWORD dwInNUcastPkts;
DWORD dwInDiscards;
DWORD dwInErrors;
DWORD dwInUnknownProtos;
DWORD dwOutOctets;
DWORD dwOutUcastPkts;
DWORD dwOutNUcastPkts;
DWORD dwOutDiscards;
DWORD dwOutErrors;
DWORD dwOutQLen;
DWORD dwDescrLen;
UCHAR bDescr[MAXLEN_IFDESCR];
} MIB_IFROW, *PMIB_IFROW;
Члены
wszName[MAX_INTERFACE_NAME_LEN]
Тип: WCHAR[MAX_INTERFACE_NAME_LEN]
Указатель на строку Юникода, содержащую имя интерфейса.
dwIndex
Тип: DWORD
Индекс, идентифицирующий интерфейс. Это значение индекса может измениться, если сетевой адаптер отключен и включен, и его не следует считать постоянным.
dwType
Тип: DWORD
Тип интерфейса, определенный центром имен, назначенных Через Интернет (IANA). Для получения дополнительной информации см. http://www.iana.org/assignments/ianaiftype-mib. Возможные значения для типа интерфейса перечислены в файле заголовка Ipifcons.h .
В приведенной ниже таблице перечислены общие значения для типа интерфейса, хотя возможны и многие другие значения.
dwMtu
Тип: DWORD
Максимальный размер единицы передачи (MTU) в байтах.
dwSpeed
Тип: DWORD
Скорость интерфейса в битах в секунду.
dwPhysAddrLen
Тип: DWORD
Длина (в байтах) физического адреса, указанного членом bPhysAddr .
bPhysAddr[MAXLEN_PHYSADDR]
Тип: BYTE[MAXLEN_PHYSADDR]
Физический адрес адаптера для этого интерфейса.
dwAdminStatus
Тип: DWORD
Интерфейс включен или отключен в административном режиме.
dwOperStatus
Тип: DWORD
Рабочее состояние интерфейса. Этот член может быть одним из следующих значений, определенных в перечислении INTERNAL_IF_OPER_STATUS, определенном в файле заголовка Ipifcons.h .
dwLastChange
Тип: DWORD
Продолжительность времени в сотых секундах (10^-2 с), начиная с последней перезагрузки компьютера, когда интерфейс вступил в текущее рабочее состояние. Это значение переворачивается через 2^32 сотые секунды.
Член dwLastChange в настоящее время не поддерживается NDIS. В Windows Vista и более поздних версиях NDIS возвращает ноль для этого элемента. В более ранних версиях Windows в этом элементе возвращается произвольное значение для интерфейсов, поддерживаемых NDIS. Для интерфейсов, поддерживаемых другими поставщиками интерфейсов, они могут возвращать соответствующее значение.
dwInOctets
Тип: DWORD
Количество октетов данных, полученных через этот интерфейс.
dwInUcastPkts
Тип: DWORD
Количество одноадресных пакетов, полученных через этот интерфейс.
dwInNUcastPkts
Тип: DWORD
Количество пакетов, не являющихся одноадресными, полученных через этот интерфейс. Широковещательные и многоадресные пакеты включены.
dwInDiscards
Тип: DWORD
Количество отброшенных входящих пакетов, даже если в них не было ошибок.
dwInErrors
Тип: DWORD
Количество входящих пакетов, которые были отменены из-за ошибок.
dwInUnknownProtos
Тип: DWORD
Количество входящих пакетов, которые были отменены, так как протокол неизвестен.
dwOutOctets
Тип: DWORD
Количество октетов данных, отправленных через этот интерфейс.
dwOutUcastPkts
Тип: DWORD
Количество одноадресных пакетов, отправленных через этот интерфейс.
dwOutNUcastPkts
Тип: DWORD
Количество пакетов, не являющихся одноадресными, отправляемых через этот интерфейс. Широковещательные и многоадресные пакеты включены.
dwOutDiscards
Тип: DWORD
Количество исходящих пакетов, которые были отменены, даже если в них не было ошибок.
dwOutErrors
Тип: DWORD
Количество исходящих пакетов, которые были отменены из-за ошибок.
dwOutQLen
Тип: DWORD
Длина очереди передачи. В настоящее время это поле не используется.
dwDescrLen
Тип: DWORD
Длина элемента bDescr (в байтах).
bDescr[MAXLEN_IFDESCR]
Тип: BYTE[MAXLEN_IFDESCR]
Описание интерфейса.
Комментарии
Член dwSpeedструктуры MIB_IFROW будет неправильным для очень высокоскоростных сетевых интерфейсов (например, сетевого адаптера 10 Гбит/с), так как максимальное значение, которое может храниться в DWORD, равно 4 294 967 295. Приложения должны использовать структуру MIB_IF_ROW2 , возвращаемую функциями GetIfEntry2 и GetIfTable2 , или структуру IP_ADAPTER_ADDRESSES , возвращаемую функцией GetAdaptersAddresses , для определения скорости для очень высокоскоростных сетевых интерфейсов.
В microsoft пакет средств разработки программного обеспечения для Windows (SDK), выпущенном для Windows Vista и более поздних версий, организация файлов заголовков изменилась, а структура MIB_IFROW определена в файле заголовка Ifmib.h, а не в файле заголовка Iprtrmib.h. Обратите внимание, что файл заголовка Ifmib.h автоматически включается в iprtrmib.h , который автоматически включается в файл заголовка Iphlpapi.h . Файлы заголовков Ifmib.h и Iprtrmib.h никогда не следует использовать напрямую.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | ifmib.h (включая Iphlpapi.h) |