NET_IF_INFORMATION struttura (ndis.h)

Articolo
08/07/2023

La struttura NET_IF_INFORMATION fornisce NDIS con informazioni su un'interfaccia di rete registrata.

Sintassi

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

Struttura NDIS_OBJECT_HEADER per la struttura delle informazioni dell'interfaccia (NET_IF_INFORMATION). Il provider imposta il membro Type della struttura che Header specifica per NDIS_OBJECT_TYPE_DEFAULT, il membro Revision su NDIS_OBJECT_REVISION_1 e il membro Size su NDIS_SIZEOF_NET_IF_INFORMATION_REVISION_1.

Flags

Flag che forniscono informazioni sull'interfaccia descritta da questa struttura. Questi flag vengono combinati con un'operazione OR bit per bit. Se nessuno dei flag si applica, impostare questo membro su zero. I valori di flag seguenti sono definiti:

NIIF_HARDWARE_INTERFACE

Impostare se l'interfaccia di rete è per l'hardware.

NIIF_FILTER_INTERFACE

Impostare se l'interfaccia di rete è per un modulo di filtro.

NIIF_NDIS_RESERVED1

Riservato per NDIS.

NIIF_NDIS_RESERVED2

Riservato per NDIS.

NIIF_NDIS_RESERVED3

Riservato per NDIS.

PhysicalLocation

Posizione fisica per l'hardware associato a un'interfaccia specificata in un NET_PHYSICAL_LOCATION struttura.

WanTunnelType

TunnelIfEncapsMethod (da RFC 2667) per i dispositivi WAN. Se il tipo di tunnel WAN è sconosciuto, impostare questo membro su NIIF_WAN_TUNNEL_TYPE_UNKNOWN.

PortNumber

Numero di porta NDIS per l'interfaccia.

AccessType

Tipo di accesso all'interfaccia di rete NDIS NET_IF_ACCESS_TYPE .

DirectionType

Tipo di direzione dell'interfaccia di rete NDIS NET_IF_DIRECTION_TYPE.

ConnectionType

Tipo di connessione dell'interfaccia di rete NDIS NET_IF_CONNECTION_TYPE.

ifConnectorPresent

Valore booleano che indica se è presente un connettore. Impostare questo valore su TRUE se è presente un adattatore fisico o FALSE se non è presente alcuna scheda fisica.

PhysAddressLength

Lunghezza, in byte, dell'indirizzo fisico o dell'indirizzo MAC. Questa lunghezza è la lunghezza delle matrici di byte che si trovano negli offset specificati dai membri PhysAddressOffset e PermanentPhysAddressOffset .

PhysAddressOffset

Offset dell'indirizzo fisico corrente, in byte, dall'inizio di questa struttura. L'indirizzo fisico corrente è una matrice di byte. La lunghezza della matrice viene specificata nel membro PhysAddressLength . L'indirizzo fisico corrente è lo stesso valore restituito dall'OID OID_802_3_CURRENT_ADDRESS .

PermanentPhysAddressOffset

Offset dell'indirizzo fisico permanente, in byte, dall'inizio di questa struttura. L'indirizzo fisico permanente è una matrice di byte. La lunghezza della matrice viene specificata nel membro PhysAddressLength . L'indirizzo fisico permanente è lo stesso valore restituito dall'OID OID_802_3_PERMANENT_ADDRESS .

FriendlyNameLength

Lunghezza, in byte, del nome descrittivo per l'interfaccia descritta da questa struttura. Questa lunghezza è la lunghezza della matrice WCHAR che si trova all'offset nel membro FriendlyNameOffset .

FriendlyNameOffset

Offset dell'inizio del nome descrittivo, in byte, dall'inizio di questa struttura. Questo nome deve includere il nome del produttore, del prodotto e della versione dell'hardware e del software dell'interfaccia. Il nome viene specificato come matrice di valori WCHAR. Il membro FriendlyNameLength specifica la lunghezza della matrice.

InterfaceGuid

GUID associato all'interfaccia. Il provider di interfaccia genera il GUID dell'interfaccia per l'interfaccia. Il provider può chiamare la routine ExUuidCreate per creare il GUID. Il GUID dell'interfaccia deve essere associato al valore NET_LUID assegnato all'interfaccia. Se il provider conserva informazioni sull'interfaccia nell'archiviazione persistente, deve salvare il GUID e riutilizzare il GUID quando riregistra l'interfaccia dopo il riavvio del computer.

NetworkGuid

GUID associato alla rete a cui appartiene l'interfaccia. Se il provider di interfaccia non può fornire il GUID di rete, può passare un GUID zero. In questo caso, NDIS registrerà l'interfaccia nella rete predefinita del compartimento primario.

SupportedStatistics

Statistiche supportate dall'interfaccia. Per altre informazioni, vedere il membro SupportedStatistics dell'oggetto NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES struttura .

MediaType

Tipo NdisMediumXxx supportato dall'interfaccia. Per altre informazioni, vedere NDIS_MEDIUM.

PhysicalMediumType

Tipo medio fisico per l'interfaccia. Per altre informazioni, vedere OID_GEN_PHYSICAL_MEDIUM

Commenti

Un provider di interfaccia di rete inizializza una struttura NET_IF_INFORMATION per fornire NDIS con informazioni su un'interfaccia registrata. Per registrare un'interfaccia, un provider passa un puntatore a una struttura NET_IF_INFORMATION Funzione NdisIfRegisterInterface .

Il provider di interfacce deve allocare memoria sufficiente per la struttura e le matrici specificate dai membri PhysAddressOffset, PermanentPhysAddressOffset e FriendlyNameOffset. Il provider deve fornire i valori per le matrici dopo la struttura e impostare i membri di offset per identificare la posizione delle matrici.