структура NDIS_INTERFACE_INFORMATION (ifdef.h)

Статья
08/24/2023

Структура NDIS_INTERFACE_INFORMATION предоставляет сведения о сетевом интерфейсе для OID_GEN_INTERFACE_INFO OID.

Синтаксис

typedef struct _NDIS_INTERFACE_INFORMATION {
  NET_IF_OPER_STATUS         ifOperStatus;
  ULONG                      ifOperStatusFlags;
  NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
  NET_IF_MEDIA_DUPLEX_STATE  MediaDuplexState;
  ULONG                      ifMtu;
  BOOLEAN                    ifPromiscuousMode;
  BOOLEAN                    ifDeviceWakeUpEnable;
  ULONG64                    XmitLinkSpeed;
  ULONG64                    RcvLinkSpeed;
  ULONG64                    ifLastChange;
  ULONG64                    ifCounterDiscontinuityTime;
  ULONG64                    ifInUnknownProtos;
  ULONG64                    ifInDiscards;
  ULONG64                    ifInErrors;
  ULONG64                    ifHCInOctets;
  ULONG64                    ifHCInUcastPkts;
  ULONG64                    ifHCInMulticastPkts;
  ULONG64                    ifHCInBroadcastPkts;
  ULONG64                    ifHCOutOctets;
  ULONG64                    ifHCOutUcastPkts;
  ULONG64                    ifHCOutMulticastPkts;
  ULONG64                    ifHCOutBroadcastPkts;
  ULONG64                    ifOutErrors;
  ULONG64                    ifOutDiscards;
  ULONG64                    ifHCInUcastOctets;
  ULONG64                    ifHCInMulticastOctets;
  ULONG64                    ifHCInBroadcastOctets;
  ULONG64                    ifHCOutUcastOctets;
  ULONG64                    ifHCOutMulticastOctets;
  ULONG64                    ifHCOutBroadcastOctets;
  NET_IF_COMPARTMENT_ID      CompartmentId;
  ULONG                      SupportedStatistics;
} NDIS_INTERFACE_INFORMATION, *PNDIS_INTERFACE_INFORMATION;

Члены

ifOperStatus

Рабочее состояние интерфейса. Это состояние совпадает со значением, которое возвращает OID_GEN_OPERATIONAL_STATUS OID.

ifOperStatusFlags

Флаги рабочего состояния интерфейса. Это поле зарезервировано для поставщика прокси-интерфейса NDIS. Другие поставщики интерфейса должны установить для этого элемента значение 0.

MediaConnectState

Тип состояния подключения NET_IF_MEDIA_CONNECT_STATE .

MediaDuplexState

Дуплексное состояние мультимедиа интерфейса. Это состояние совпадает со значением, которое возвращает OID_GEN_MEDIA_DUPLEX_STATE OID.

ifMtu

Максимальная единица передачи (MTU) интерфейса. Этот MTU совпадает со значением, которое возвращает OID_GEN_MAXIMUM_FRAME_SIZE OID.

ifPromiscuousMode

Логическое значение, равное TRUE , если интерфейс находится в неизвестном режиме, или FALSE , если это не так. Это значение совпадает со значением, которое OID_GEN_PROMISCUOUS_MODE возвращает запрос OID.

ifDeviceWakeUpEnable

Логическое значение, равное TRUE , если интерфейс поддерживает функцию пробуждения по локальной сети и эта возможность включена, или FALSE , если это не так.

XmitLinkSpeed

Скорость канала передачи интерфейса в байтах в секунду. Эта скорость совпадает со значением, которое возвращает запрос OID_GEN_XMIT_LINK_SPEED OID.

RcvLinkSpeed

Скорость канала приема (в байтах в секунду) интерфейса. Эта скорость совпадает со значением, которое возвращает запрос OID_GEN_RCV_LINK_SPEED OID.

ifLastChange

Время, когда интерфейс вошел в текущее рабочее состояние. Это время совпадает со значением, возвращающимся запросом OID_GEN_LAST_CHANGE OID.

ifCounterDiscontinuityTime

Время последнего разрыва счетчиков интерфейса. На этот раз совпадает со значением, возвращающимся запросом OID_GEN_DISCONTINUITY_TIME OID.

ifInUnknownProtos

Количество пакетов, полученных через интерфейс и отклоненных из-за неизвестного или неподдерживаемого протокола. Это число совпадает со значением, которое возвращает запрос OID_GEN_UNKNOWN_PROTOS OID.

ifInDiscards

Количество отброшенных входящих пакетов, даже если ошибки не обнаружены, чтобы предотвратить их доставку в протокол более высокого уровня. Это число совпадает со значением, которое возвращает запрос OID_GEN_RCV_DISCARDS OID.

ifInErrors

Количество входящих пакетов, содержащих ошибки, которые препятствовали их доставке в протокол более высокого уровня. Это число совпадает со значением, которое возвращает запрос OID_GEN_RCV_ERROR OID.

ifHCInOctets

Общее количество байтов, полученных в этом интерфейсе. Это число совпадает со значением, которое возвращает OID_GEN_BYTES_RCV OID.

ifHCInUcastPkts

Количество направленных пакетов, полученных без ошибок в интерфейсе. Это число совпадает со значением, которое возвращает запрос OID_GEN_DIRECTED_FRAMES_RCV OID.

ifHCInMulticastPkts

Количество многоадресных или функциональных пакетов, полученных без ошибок в интерфейсе. Это число совпадает со значением, возвращающимся запросом OID_GEN_MULTICAST_FRAMES_RCV OID.

ifHCInBroadcastPkts

Количество широковещательных пакетов, полученных без ошибок в интерфейсе. Это число совпадает со значением, которое возвращает запрос OID_GEN_BROADCAST_FRAMES_RCV OID.

ifHCOutOctets

Число байтов, передаваемых без ошибок в интерфейсе. Это число совпадает со значением, возвращающимся запросом OID_GEN_BYTES_XMIT OID.

ifHCOutUcastPkts

Количество направленных пакетов, которые передаются без ошибок в интерфейсе. Это число совпадает со значением, возвращающимся запросом OID_GEN_DIRECTED_FRAMES_XMIT OID.

ifHCOutMulticastPkts

Количество многоадресных или функциональных пакетов, передаваемых без ошибок в интерфейсе. Это число совпадает со значением, возвращающимся запросом OID_GEN_MULTICAST_FRAMES_XMIT OID.

ifHCOutBroadcastPkts

Количество широковещательных пакетов, передаваемых без ошибок в интерфейсе. Это число совпадает со значением, возвращаемое запросом OID_GEN_BROADCAST_FRAMES_XMIT OID.

ifOutErrors

Количество пакетов, которые интерфейс не может передать. Это число совпадает со значением, которое возвращает запрос OID OID_GEN_XMIT_ERROR .

ifOutDiscards

Количество пакетов, отбрасываемых интерфейсом. Это число совпадает со значением, которое возвращает запрос OID_GEN_XMIT_DISCARDS OID.

ifHCInUcastOctets

Количество байтов в направленных пакетах, полученных без ошибок. Это значение является тем же значением, которое возвращает OID_GEN_DIRECTED_BYTES_RCV .

ifHCInMulticastOctets

Количество байтов в многоадресных или функциональных пакетах, полученных без ошибок. Это число является тем же значением, которое возвращает OID_GEN_MULTICAST_BYTES_RCV .

ifHCInBroadcastOctets

Количество байтов в широковещательных пакетах, полученных без ошибок. Это то же значение, которое возвращает OID_GEN_BROADCAST_BYTES_RCV .

ifHCOutUcastOctets

Количество байтов в направленных пакетах, которые передаются без ошибок. Это значение является тем же значением, которое возвращает OID_GEN_DIRECTED_BYTES_XMIT .

ifHCOutMulticastOctets

Количество байтов в многоадресных или функциональных пакетах, которые передаются без ошибок. Это число является тем же значением, которое возвращает OID_GEN_MULTICAST_BYTES_XMIT .

ifHCOutBroadcastOctets

Количество байтов в широковещательных пакетах, которые передаются без ошибок. Это число является тем же значением, которое OID_GEN_BROADCAST_BYTES_XMIT возвращает.

CompartmentId

Секция, к которой принадлежит интерфейс, если поставщик интерфейса может предоставить идентификатор секции, к которой принадлежит интерфейс. В противном случае он должен вернуть NET_IF_COMPARTMENT_ID_UNSPECIFIED. Если поставщик интерфейса возвращает NET_IF_COMPARTMENT_ID_UNSPECIFIED для идентификатора секции, NDIS вернет правильный идентификатор секции для этого интерфейса.

SupportedStatistics

Поддерживаемая статистика. Дополнительные сведения см. в разделе Элемент SupportedStatistics структуры NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES .

Поставщики интерфейсов NDIS заполняют структуру NDIS_INTERFACE_INFORMATION в ответ на запрос OID_GEN_INTERFACE_INFO OID. Эта структура содержит сведения, которые изменяются в течение жизненного цикла интерфейса.

Для регистрации в качестве поставщика интерфейса драйвер NDIS вызывает функцию NdisIfRegisterProvider .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 в Windows Vista.
Верхняя часть	ifdef.h (включая Ndis.h)