estrutura NET_IF_INFORMATION (ndis.h)

Artigo
02/26/2024

A estrutura NET_IF_INFORMATION fornece ao NDIS informações sobre um adaptador de rede registrado.

Sintaxe

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;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura de informações da interface (NET_IF_INFORMATION). O provedor define o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_DEFAULT, o membro Revision como NDIS_OBJECT_REVISION_1 e o membro Size como NDIS_SIZEOF_NET_IF_INFORMATION_REVISION_1.

Flags

Sinalizadores que fornecem informações sobre a interface que essa estrutura descreve. Esses sinalizadores são combinados com uma operação OR bit a bit. Se nenhum dos sinalizadores se aplicar, defina esse membro como zero. Os seguintes valores de sinalizador são definidos:

NIIF_HARDWARE_INTERFACE

Defina se o adaptador de rede for para hardware.

NIIF_FILTER_INTERFACE

Defina se o adaptador de rede for para um módulo de filtro.

NIIF_NDIS_RESERVED1

Reservado para NDIS.

NIIF_NDIS_RESERVED2

Reservado para NDIS.

NIIF_NDIS_RESERVED3

Reservado para NDIS.

PhysicalLocation

O local físico para o hardware associado a uma interface especificada em um NET_PHYSICAL_LOCATION estrutura.

WanTunnelType

O tunnelIfEncapsMethod (do RFC 2667) para dispositivos WAN. Se o tipo de túnel WAN for desconhecido, defina esse membro como NIIF_WAN_TUNNEL_TYPE_UNKNOWN.

PortNumber

O número da porta NDIS para a interface.

AccessType

Um tipo de acesso de interface de rede NDIS NET_IF_ACCESS_TYPE.

DirectionType

Um tipo de direção de interface de rede NDIS NET_IF_DIRECTION_TYPE.

ConnectionType

Um tipo de conexão de interface de rede NDIS NET_IF_CONNECTION_TYPE.

ifConnectorPresent

Um valor booliano que indica se um conector está presente. Defina esse valor como TRUE se houver um adaptador físico ou FALSE se não houver nenhum adaptador físico.

PhysAddressLength

O comprimento, em bytes, do endereço físico ou endereço MAC. Esse comprimento é o comprimento das matrizes de bytes que estão localizadas nos deslocamentos que os membros PhysAddressOffset e PermanentPhysAddressOffset especificam.

PhysAddressOffset

O deslocamento do endereço físico atual, em bytes, desde o início dessa estrutura. O endereço físico atual é uma matriz de bytes. O comprimento da matriz é especificado no membro PhysAddressLength . O endereço físico atual é o mesmo valor que o OID OID_802_3_CURRENT_ADDRESS retorna.

PermanentPhysAddressOffset

O deslocamento do endereço físico permanente, em bytes, desde o início dessa estrutura. O endereço físico permanente é uma matriz de bytes. O comprimento da matriz é especificado no membro PhysAddressLength . O endereço físico permanente é o mesmo valor que o OID OID_802_3_PERMANENT_ADDRESS retorna.

FriendlyNameLength

O comprimento, em bytes, do nome amigável para a interface que essa estrutura descreve. Esse comprimento é o comprimento da matriz WCHAR localizada no deslocamento no membro FriendlyNameOffset .

FriendlyNameOffset

O deslocamento do início do nome amigável, em bytes, desde o início dessa estrutura. Esse nome deve incluir o nome do fabricante, o produto e a versão do hardware e do software da interface. O nome é especificado como uma matriz de valores WCHAR. O membro FriendlyNameLength especifica o comprimento da matriz.

InterfaceGuid

O GUID associado à interface . O provedor de interface gera o GUID da interface para a interface. O provedor pode chamar a rotina ExUuidCreate para criar o GUID. O GUID da interface deve ser associado ao valor NET_LUID atribuído à interface. Se o provedor reter informações sobre a interface no armazenamento persistente, ele deverá salvar o GUID e reutilizar o GUID quando ele registrar novamente a interface após a reinicialização do computador.

NetworkGuid

O GUID associado à rede à qual a interface pertence. Se o provedor de interface não puder fornecer o GUID de rede, ele poderá passar um GUID zero. Nesse caso, o NDIS registrará a interface na rede padrão do compartimento primário.

SupportedStatistics

As estatísticas compatíveis com a interface. Para obter mais informações, consulte o membro SupportedStatistics do NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES estrutura .

MediaType

O tipo NdisMediumXxx que a interface dá suporte. Para obter mais informações, consulte NDIS_MEDIUM.

PhysicalMediumType

O tipo médio físico para a interface. Para obter mais informações, consulte OID_GEN_PHYSICAL_MEDIUM

Comentários

Um provedor de interface de rede inicializa uma estrutura de NET_IF_INFORMATION para fornecer ao NDIS informações sobre uma interface registrada. Para registrar uma interface, um provedor passa um ponteiro para uma estrutura NET_IF_INFORMATION para o Função NdisIfRegisterInterface .

O provedor de interface deve alocar memória suficiente para a estrutura e as matrizes especificadas pelos membros PhysAddressOffset, PermanentPhysAddressOffset e FriendlyNameOffset . O provedor deve fornecer os valores para as matrizes após a estrutura e definir os membros de deslocamento para identificar o local das matrizes.