NET_IF_INFORMATION-Struktur (ndis.h)
Die NET_IF_INFORMATION-Struktur stellt NDIS Informationen zu einer registrierten Netzwerkschnittstelle zur Verfügung.
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;
Member
Header
Die NDIS_OBJECT_HEADER-Struktur für die Schnittstelleninformationsstruktur (NET_IF_INFORMATION). Der Anbieter legt das Type-Element der Struktur, die Header angibt, auf NDIS_OBJECT_TYPE_DEFAULT fest, der Revisionsmember auf NDIS_OBJECT_REVISION_1 und das Size-Element auf NDIS_SIZEOF_NET_IF_INFORMATION_REVISION_1.
Flags
Flags, die Informationen über die Schnittstelle bereitstellen, die diese Struktur beschreibt. Diese Flags werden mit einem bitweisen OR-Vorgang kombiniert. Wenn keines der Flags zutrifft, legen Sie dieses Element auf 0 fest. Die folgenden Flagwerte werden definiert:
NIIF_HARDWARE_INTERFACE
Legen Sie fest, ob die Netzwerkschnittstelle für Hardware verwendet wird.
NIIF_FILTER_INTERFACE
Legen Sie fest, ob die Netzwerkschnittstelle für ein Filtermodul verwendet wird.
NIIF_NDIS_RESERVED1
Reserviert für NDIS.
NIIF_NDIS_RESERVED2
Reserviert für NDIS.
NIIF_NDIS_RESERVED3
Reserviert für NDIS.
PhysicalLocation
Der physische Speicherort für die Hardware, die einer in einer angegebenen Schnittstelle zugeordnet ist NET_PHYSICAL_LOCATION Struktur.
WanTunnelType
TunnelIfEncapsMethod (aus RFC 2667) für WAN-Geräte. Wenn der WAN-Tunneltyp unbekannt ist, legen Sie diesen Member auf NIIF_WAN_TUNNEL_TYPE_UNKNOWN fest.
PortNumber
Die NDIS-Portnummer für die Schnittstelle.
AccessType
Ein NET_IF_ACCESS_TYPE NDIS-Netzwerkschnittstellenzugriffstyp.
DirectionType
Ein NET_IF_DIRECTION_TYPE NDIS-Netzwerkschnittstellenrichtungstyp.
ConnectionType
Ein NET_IF_CONNECTION_TYPE NDIS-Netzwerkschnittstellenverbindungstyp.
ifConnectorPresent
Ein boolescher Wert, der angibt, ob ein Connector vorhanden ist. Legen Sie diesen Wert auf TRUE fest, wenn ein physischer Adapter vorhanden ist, oder auf FALSE , wenn kein physischer Adapter vorhanden ist.
PhysAddressLength
Die Länge der physischen Adresse oder MAC-Adresse in Bytes. Diese Länge ist die Länge der Bytearrays, die sich an den Offsets befinden, die die Member PhysAddressOffset und PermanentPhysAddressOffset angeben.
PhysAddressOffset
Der Offset der aktuellen physischen Adresse in Bytes vom Anfang dieser Struktur. Die aktuelle physische Adresse ist ein Array von Bytes. Die Länge des Arrays wird im PhysAddressLength-Element angegeben. Die aktuelle physische Adresse ist derselbe Wert, den die OID_802_3_CURRENT_ADDRESS OID zurückgibt.
PermanentPhysAddressOffset
Der Offset der permanenten physischen Adresse in Bytes vom Anfang dieser Struktur. Die permanente physische Adresse ist ein Array von Bytes. Die Länge des Arrays wird im PhysAddressLength-Element angegeben. Die permanente physische Adresse ist derselbe Wert, den die OID_802_3_PERMANENT_ADDRESS OID zurückgibt.
FriendlyNameLength
Die Länge des Anzeigenamens für die Schnittstelle, die diese Struktur beschreibt. Diese Länge ist die Länge des WCHAR-Arrays, das sich im Offset im FriendlyNameOffset-Element befindet.
FriendlyNameOffset
Der Offset des Anfangs des Anzeigenamens in Bytes vom Anfang dieser Struktur. Dieser Name sollte den Namen des Herstellers, das Produkt und die Version der Schnittstellenhardware und -software enthalten. Der Name wird als Array von WCHAR-Werten angegeben. Das FriendlyNameLength-Element gibt die Länge des Arrays an.
InterfaceGuid
Die GUID, die der Schnittstelle zugeordnet ist. Der Schnittstellenanbieter generiert die Schnittstellen-GUID für die Schnittstelle. Der Anbieter kann die ExUuidCreate-Routine aufrufen, um die GUID zu erstellen. Die Schnittstellen-GUID sollte dem NET_LUID Wert zugeordnet werden, der der Schnittstelle zugewiesen ist. Wenn der Anbieter Informationen zur Schnittstelle im persistenten Speicher beibehält, sollte er die GUID speichern und die GUID wiederverwenden, wenn die Schnittstelle nach dem Neustart des Computers erneut registriert wird.
NetworkGuid
Die GUID, die dem Netzwerk zugeordnet ist, zu dem die Schnittstelle gehört. Wenn der Schnittstellenanbieter die Netzwerk-GUID nicht bereitstellen kann, kann er eine NULL-GUID übergeben. In diesem Fall registriert NDIS die Schnittstelle im Standardnetzwerk des primären Abteils.
SupportedStatistics
Die von der Schnittstelle unterstützten Statistiken. Weitere Informationen finden Sie im SupportedStatistics-Member des NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES Struktur .
MediaType
Der NdisMediumXxx-Typ , den die Schnittstelle unterstützt. Weitere Informationen finden Sie unter NDIS_MEDIUM.
PhysicalMediumType
Der physische Mediumtyp für die Schnittstelle. Weitere Informationen finden Sie unter OID_GEN_PHYSICAL_MEDIUM
Hinweise
Ein Netzwerkschnittstellenanbieter initialisiert eine NET_IF_INFORMATION-Struktur, um NDIS Informationen zu einer registrierten Schnittstelle bereitzustellen. Um eine Schnittstelle zu registrieren, übergibt ein Anbieter einen Zeiger auf eine NET_IF_INFORMATION-Struktur an die NdisIfRegisterInterface-Funktion .
Der Schnittstellenanbieter sollte genügend Arbeitsspeicher für die Struktur und die Arrays zuweisen, die die Mitglieder PhysAddressOffset, PermanentPhysAddressOffset und FriendlyNameOffset angeben. Der Anbieter muss die Werte für die Arrays nach der Struktur bereitstellen und die Offsetmember festlegen, um den Speicherort der Arrays zu identifizieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.0 und höher. |
| Kopfzeile | ndis.h (einschließlich Ndis.h) |