struttura NET_IF_INFORMATION (ndis.h)

2025-02-07

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;

Membri

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 di NDIS_OBJECT_TYPE_DEFAULT, il membro revision NDIS_OBJECT_REVISION_1 e il membro Size a 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 viene applicato, impostare questo membro su zero. Sono definiti i valori di flag seguenti:

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 oggetto 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 dell'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 una scheda fisica 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 in corrispondenza degli 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 in corrispondenza dell'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, il prodotto e la 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 mantiene le informazioni sull'interfaccia nell'archiviazione permanente, 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 raggruppamento primario.

SupportedStatistics

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

MediaType

Il 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

Osservazioni

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

Il provider di interfaccia deve allocare memoria sufficiente per la struttura e le matrici specificate dai membri FriendlyNameOffset PhysAddressOffset, PermanentPhysAddressOffsete 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.