структура NET_IF_INFORMATION (ndis.h)

Структура NET_IF_INFORMATION предоставляет NDIS с информацией о зарегистрированном сетевом интерфейсе.

Syntax

typedef struct _NET_IF_INFORMATION {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NET_PHYSICAL_LOCATION  PhysicalLocation;
  ULONG                  WanTunnelType;
  ULONG                  PortNumber;
  NET_IF_ACCESS_TYPE     AccessType;
  NET_IF_DIRECTION_TYPE  DirectionType;
  NET_IF_CONNECTION_TYPE ConnectionType;
  BOOLEAN                ifConnectorPresent;
  USHORT                 PhysAddressLength;
  USHORT                 PhysAddressOffset;
  USHORT                 PermanentPhysAddressOffset;
  USHORT                 FriendlyNameLength;
  USHORT                 FriendlyNameOffset;
  GUID                   InterfaceGuid;
  NET_IF_NETWORK_GUID    NetworkGuid;
  ULONG                  SupportedStatistics;
  NDIS_MEDIUM            MediaType;
  NDIS_PHYSICAL_MEDIUM   PhysicalMediumType;
} NET_IF_INFORMATION, *PNET_IF_INFORMATION;

Members

Header

The NDIS_OBJECT_HEADER structure for the interface information structure (NET_IF_INFORMATION). The provider sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT, the Revision member to NDIS_OBJECT_REVISION_1, and the Size member to NDIS_SIZEOF_NET_IF_INFORMATION_REVISION_1.

Flags

Флаги, предоставляющие сведения об интерфейсе, описываемом этой структурой. Эти флаги объединяются с побитовой операцией OR. Если ни один из флагов не применяется, установите для этого элемента значение нулю. Определены следующие значения флагов:

NIIF_HARDWARE_INTERFACE

Задайте, если сетевой интерфейс предназначен для оборудования.

NIIF_FILTER_INTERFACE

Задайте, если сетевой интерфейс предназначен для модуля фильтра.

NIIF_NDIS_RESERVED1

Зарезервировано для NDIS.

NIIF_NDIS_RESERVED2

Зарезервировано для NDIS.

NIIF_NDIS_RESERVED3

Зарезервировано для NDIS.

PhysicalLocation

Физическое расположение оборудования, связанного с интерфейсом, указанным в NET_PHYSICAL_LOCATION structure.

WanTunnelType

ТуннельIfEncapsMethod (из RFC 2667) для устройств глобальной сети. Если тип туннеля глобальной сети неизвестен, задайте для этого элемента значение NIIF_WAN_TUNNEL_TYPE_UNKNOWN.

PortNumber

Номер порта NDIS для интерфейса.

AccessType

A NET_IF_ACCESS_TYPE NDIS network interface access type.

DirectionType

A NET_IF_DIRECTION_TYPE NDIS network interface direction type.

ConnectionType

A NET_IF_CONNECTION_TYPE NDIS network interface connection type.

ifConnectorPresent

Логическое значение, указывающее, присутствует ли соединитель. Set this value to TRUE if there is a physical adapter or FALSE if there is no physical adapter.

PhysAddressLength

Длина физического адреса или MAC-адреса в байтах. This length is the length of the byte arrays that are located at the offsets that the PhysAddressOffset and PermanentPhysAddressOffset members specify.

PhysAddressOffset

Смещение текущего физического адреса в байтах с начала этой структуры. Текущий физический адрес — это массив байтов. The length of the array is specified in the PhysAddressLength member. The current physical address is the same value that the OID_802_3_CURRENT_ADDRESS OID returns.

PermanentPhysAddressOffset

Смещение постоянного физического адреса в байтах с начала этой структуры. Постоянный физический адрес — это массив байтов. The length of the array is specified in the PhysAddressLength member. The permanent physical address is the same value that the OID_802_3_PERMANENT_ADDRESS OID returns.

FriendlyNameLength

Длина в байтах понятного имени интерфейса, описываемого этой структурой. This length is the length of the WCHAR array that is located at the offset in the FriendlyNameOffset member.

FriendlyNameOffset

Смещение начала понятного имени в байтах с начала этой структуры. Это имя должно включать имя производителя, продукта и версию оборудования и программного обеспечения интерфейса. Имя указывается в виде массива значений WCHAR. The FriendlyNameLength member specifies the length of the array.

InterfaceGuid

GUID, связанный с интерфейсом. Поставщик интерфейса создает GUID интерфейса для интерфейса. The provider can call the ExUuidCreate routine to create the GUID. The interface GUID should be associated with the NET_LUID value that is assigned to the interface. Если поставщик сохраняет сведения об интерфейсе в постоянном хранилище, он должен сохранить GUID и повторно использовать GUID при повторной регистрации интерфейса после перезагрузки компьютера.

NetworkGuid

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

SupportedStatistics

Статистика, которую поддерживает интерфейс. For more information, see the SupportedStatistics member of the NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES structure .

MediaType

The NdisMediumXxx type that the interface supports. For more information, see NDIS_MEDIUM.

PhysicalMediumType

Физический тип среды для интерфейса. For more information, see OID_GEN_PHYSICAL_MEDIUM

Remarks

Поставщик сетевого интерфейса инициализирует структуру NET_IF_INFORMATION для предоставления NDIS сведений о зарегистрированном интерфейсе. Чтобы зарегистрировать интерфейс, поставщик передает указатель на структуру NET_IF_INFORMATION NdisIfRegisterInterface function.

The interface provider should allocate enough memory for the structure and the arrays that the PhysAddressOffset, PermanentPhysAddressOffset, and FriendlyNameOffset members specify. Поставщик должен указать значения массивов после структуры и задать элементы смещения, чтобы определить расположение массивов.

Requirements

See also

ExUuidCreate

NDIS_MEDIUM

NDIS_OBJECT_HEADER

NET_IF_ACCESS_TYPE

NET_IF_CONNECTION_TYPE

NET_IF_DIRECTION_TYPE

NET_LUID

NET_PHYSICAL_LOCATION

NdisIfRegisterInterface

OID_802_3_CURRENT_ADDRESS

OID_802_3_PERMANENT_ADDRESS

OID_GEN_PHYSICAL_MEDIUM

OID_GEN_STATISTICS