Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
In de MIB_IF_ROW2 structuur wordt informatie over een bepaalde interface opgeslagen.
Syntaxis
typedef struct _MIB_IF_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
GUID InterfaceGuid;
WCHAR Alias[IF_MAX_STRING_SIZE + 1];
WCHAR Description[IF_MAX_STRING_SIZE + 1];
ULONG PhysicalAddressLength;
UCHAR PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
UCHAR PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
ULONG Mtu;
IFTYPE Type;
TUNNEL_TYPE TunnelType;
NDIS_MEDIUM MediaType;
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
struct {
BOOLEAN HardwareInterface :1;
BOOLEAN FilterInterface :1;
BOOLEAN ConnectorPresent :1;
BOOLEAN NotAuthenticated :1;
BOOLEAN NotMediaConnected :1;
BOOLEAN Paused :1;
BOOLEAN LowPower :1;
BOOLEAN EndPointInterface :1;
} InterfaceAndOperStatusFlags;
IF_OPER_STATUS OperStatus;
NET_IF_ADMIN_STATUS AdminStatus;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_NETWORK_GUID NetworkGuid;
NET_IF_CONNECTION_TYPE ConnectionType;
ULONG64 TransmitLinkSpeed;
ULONG64 ReceiveLinkSpeed;
ULONG64 InOctets;
ULONG64 InUcastPkts;
ULONG64 InNUcastPkts;
ULONG64 InDiscards;
ULONG64 InErrors;
ULONG64 InUnknownProtos;
ULONG64 InUcastOctets;
ULONG64 InMulticastOctets;
ULONG64 InBroadcastOctets;
ULONG64 OutOctets;
ULONG64 OutUcastPkts;
ULONG64 OutNUcastPkts;
ULONG64 OutDiscards;
ULONG64 OutErrors;
ULONG64 OutUcastOctets;
ULONG64 OutMulticastOctets;
ULONG64 OutBroadcastOctets;
ULONG64 OutQLen;
} MIB_IF_ROW2, *PMIB_IF_ROW2;
Leden
InterfaceLuid-
De lokaal unieke id (LUID) voor de netwerkinterface.InterfaceIndex-
De index die de netwerkinterface identificeert. Deze indexwaarde kan veranderen wanneer een netwerkadapter is uitgeschakeld en vervolgens is ingeschakeld en niet als permanent moet worden beschouwd.InterfaceGuid-
De GUID voor de netwerkinterface.alias
Een Unicode-tekenreeks met null-beëindiging die de aliasnaam van de netwerkinterface bevat.beschrijving
Een Unicode-tekenreeks die door NULL is beëindigd en een beschrijving van de netwerkinterface bevat.PhysicalAddressLength-
De lengte, in bytes, van het fysieke hardwareadres dat het lid PhysicalAddress opgeeft.PhysicalAddress-
Het fysieke hardwareadres van de adapter voor deze netwerkinterface.PermanentPhysicalAddress-
Het permanente fysieke hardwareadres van de adapter voor deze netwerkinterface.Mtu-
De maximale MTU-grootte (Transmission Unit) in bytes voor deze netwerkinterface.type
Het interfacetype zoals gedefinieerd door de Internet Assigned Names Authority (IANA). Zie IANAifType-MIB DEFINITIONSvoor meer informatie. Mogelijke waarden voor het interfacetype worden vermeld in het headerbestand Ipifcons.h.De volgende tabel bevat algemene waarden voor het interfacetype, hoewel veel andere waarden mogelijk zijn.
Waarde Betekenis IF_TYPE_OTHER
1
Een ander type netwerkinterface
IF_TYPE_ETHERNET_CSMACD
6
Een Ethernet-netwerkinterface
IF_TYPE_ISO88025_TOKENRING
9
Een netwerkinterface voor tokenring
IF_TYPE_PPP
23
Een PPS-netwerkinterface
IF_TYPE_SOFTWARE_LOOPBACK
24
Een netwerkinterface voor software loopback
IF_TYPE_ATM
37
Een ATM-netwerkinterface
IF_TYPE_IEEE80211
71
Een IEEE 802.11 draadloze netwerkinterface
IF_TYPE_TUNNEL
131
Een tunneltype inkapselingsnetwerkinterface
IF_TYPE_IEEE1394
144
Een IEEE 1394 (Firewire) high performance serial bus network interface
TunnelType-
Als het typelid is IF_TYPE_TUNNEL, wordt een TUNNEL_TYPE type gedefinieerd dat de inkapselingsmethode definieert die een tunnel gebruikt.MediaType-
Het NDIS-mediatype voor de interface. Dit lid kan een van de volgende waarden zijn van het NDIS_MEDIUM opsommingstype dat is gedefinieerd in het headerbestand Ntddndis.h.Waarde Betekenis NdisMedium802_3
0
Een Ethernet-netwerk (802.3).
NdisMedium802_5
1
Een tokenring (802.5) netwerk.
NdisMediumFddi
2
Een FDDI-netwerk (Fiber Distributed Data Interface).
NdisMediumWan
3
Een WIDE Area Network (WAN). Dit type heeft betrekking op verschillende vormen van punt-naar-punt- en WAN-NIC's en variantadres-/headerindelingen die moeten worden onderhandeld tussen het protocolstuurprogramma en het onderliggende stuurprogramma nadat de binding tot stand is gebracht.
NdisMediumLocalTalk
4
Een LocalTalk-netwerk.
NdisMediumDix
5
Een Ethernet-netwerk waarvoor de stuurprogramma's de DIX Ethernet-headerindeling gebruiken.
NdisMediumArcnetRaw
6
Een ARCNET-netwerk.
NdisMediumArcnet878_2
7
Een ARCNET-netwerk (878.2).
NdisMediumAtm
8
Een ATM-netwerk. Verbindingsgerichte clientprotocolstuurprogramma's kunnen zichzelf binden aan een onderliggend minipoortstuurprogramma dat deze waarde retourneert. Anders binden verouderde protocolstuurprogramma's zich aan het door het systeem geleverde LanE-tussenstuurprogramma, dat het gemiddelde type rapporteert als NdisMedium802_3 of NdisMedium802_5, afhankelijk van hoe de netwerkbeheerder het LanE-stuurprogramma configureert.
NdisMediumWirelessWan
9
Een draadloos netwerk. NDIS 5. x miniportstuurprogramma's die draadloze LAN-pakketten (WLAN) of draadloze WAN-pakketten (WWAN) ondersteunen, declareren hun medium als NdisMedium802_3 en emuleren Ethernet naar NDIS-stuurprogramma's op een hoger niveau.
Opmerking Dit mediatype is niet beschikbaar voor gebruik op Windows Vista of latere versies van Windows.
NdisMediumIrda
10
Een infraroodnetwerk (IrDA).
NdisMediumBpc
11
Een broadcast-computernetwerk.
NdisMediumCoWan
12
Een wide area network in een verbindingsgerichte omgeving.
NdisMedium1394
13
Een IEEE 1394-netwerk (branddraad).
NdisMediumInfiniBand
14
Een InfiniBand-netwerk.
NdisMediumTunnel
15
Een tunnelnetwerk.
NdisMediumNative802_11
16
Een systeemeigen IEEE 802.11-netwerk.
NdisMediumLoopback
17
Een NDIS-loopbacknetwerk.
PhysicalMediumType-
Het fysieke mediumtype NDIS. Dit lid kan een van de volgende waarden zijn van het NDIS_PHYSICAL_MEDIUM opsommingstype dat is gedefinieerd in het headerbestand Ntddndis.h.Waarde Betekenis NdisPhysicalMediumUnspecified
0
Het fysieke medium is geen van de volgende waarden. Een satellietfeed in één richting is bijvoorbeeld een niet-opgegeven fysiek medium.
NdisPhysicalMediumWirelessLan
1
Pakketten worden overgebracht via een draadloos LAN-netwerk via een minipoortstuurprogramma dat voldoet aan de interface 802.11.
NdisPhysicalMediumCableModem
2
Pakketten worden overgedragen via een kabelnetwerk op basis van DOCSIS.
NdisPhysicalMediumPhoneLine
3
Pakketten worden overgedragen via standaardtelefoonlijnen. Dit type bevat HomePNA-media.
NdisPhysicalMediumPowerLine
4
Pakketten worden overgedragen via bedrading die is verbonden met een energiedistributiesysteem.
NdisPhysicalMediumDSL
5
Pakketten worden overgedragen via een DSL-netwerk (Digital Subscriber Line). Dit typeomvatt, zoals HETXE, UADSL (G.Lite) en SDSL.
NdisPhysicalMediumFibreChannel
6
Pakketten worden overgedragen via een Fibre Channel-interconnect.
NdisPhysicalMedium1394
7
Pakketten worden overgebracht via een IEEE 1394-bus.
NdisPhysicalMediumWirelessWan
8
Pakketten worden overgedragen via een draadloze WAN-koppeling. Dit type omvat CDPD, CDMA en GPRS.
NdisPhysicalMediumNative802_11
9
Pakketten worden overgebracht via een draadloos LAN-netwerk via een minipoortstuurprogramma dat voldoet aan de native 802.11-interface.
Opmerking De native 802.11-interface wordt ondersteund in NDIS 6.0 en latere versies.
NdisPhysicalMediumBluetooth
10
Pakketten worden overgebracht via een Bluetooth-netwerk. Bluetooth is een draadloze technologie van korte afstand die gebruikmaakt van het 2,4 GHz-spectrum.
NdisPhysicalMediumInfiniband
11
Pakketten worden overgedragen via een InfiniBand-interconnect.
NdisPhysicalMediumUWB
13
Pakketten worden overgebracht via een ultrabreed bandnetwerk.
NdisPhysicalMedium802_3
14
Pakketten worden overgedragen via een Ethernet-netwerk (802.3).
NdisPhysicalMedium802_5
15
Pakketten worden overgedragen via een tokenring (802.5) netwerk.
NdisPhysicalMediumIrda
16
Pakketten worden overgebracht via een infraroodnetwerk (IrDA).
NdisPhysicalMediumWiredWAN
17
Pakketten worden overgedragen via een bekabeld WAN-netwerk.
NdisPhysicalMediumWiredCoWan
18
Pakketten worden overgebracht via een wide area-netwerk in een verbindingsgerichte omgeving.
NdisPhysicalMediumOther
19
Pakketten worden overgebracht via een netwerk dat niet wordt beschreven door andere mogelijke waarden.
AccessType-
Een NET_IF_ACCESS_TYPE NDIS-netwerkinterfacetoegangstype.DirectionType-
Een NET_IF_DIRECTION_TYPE NDIS-netwerkinterfacerichtingstype.InterfaceAndOperStatusFlags-
Een set van de volgende vlaggen die informatie over de interface bieden. Deze vlaggen worden gecombineerd met een bitsgewijze OR-bewerking. Als geen van de vlaggen van toepassing is, wordt dit lid ingesteld op nul.HardwareInterface-
De netwerkinterface is voor hardware.FilterInterface-
De netwerkinterface is bedoeld voor een filtermodule.ConnectorPresent-
Er is een connector aanwezig op de netwerkinterface. Deze waarde wordt ingesteld als er een fysieke netwerkadapter is.Niet-geverifieerde
De standaardpoort voor de netwerkinterface wordt niet geverifieerd. Als een netwerkinterface niet wordt geverifieerd door het doel, bevindt de netwerkinterface zich niet in een operationele modus. Hoewel deze situatie van toepassing is op zowel bekabelde als draadloze netwerkverbindingen, is verificatie gebruikelijker voor draadloze netwerkverbindingen.NotMediaConnected-
De netwerkinterface heeft geen status die is verbonden met media. Als een netwerkkabel is losgekoppeld voor een bekabeld netwerk, wordt deze waarde ingesteld. Voor een draadloos netwerk is deze waarde ingesteld voor de netwerkadapter die niet is verbonden met een netwerk.onderbroken
De netwerkstack voor de netwerkinterface heeft de status onderbroken of onderbroken. Deze waarde betekent niet dat de computer in de slaapstand staat.LowPower-
De netwerkinterface heeft een lage energiestatus.EndPointInterface
De netwerkinterface is een eindpuntapparaat en geen echte netwerkinterface die verbinding maakt met een netwerk. Deze waarde kan worden ingesteld door apparaten, zoals smartphones, die gebruikmaken van netwerkinfrastructuur om met de computer te communiceren, maar geen connectiviteit bieden met een extern netwerk. Dit type apparaten moet deze vlag instellen.
OperStatus
Een operationele statustype van een IF_OPER_STATUS NDIS-netwerkinterface.AdminStatus
Het NET_IF_ADMIN_STATUS type beheerstatus.MediaConnectState-
Het NET_IF_MEDIA_CONNECT_STATE verbindingsstatustype.NetworkGuid-
De GUID die is gekoppeld aan het netwerk waartoe de interface behoort.ConnectionType-
Een NET_IF_CONNECTION_TYPE NDIS-netwerkinterfaceverbindingstype.TransmitLinkSpeed-
De snelheid, in bits per seconde, van de overdrachtskoppeling.ReceiveLinkSpeed-
De snelheid, in bits per seconde, van de ontvangstkoppeling.InOctets-
Het aantal octetten met gegevens dat zonder fouten wordt ontvangen via deze interface. Deze waarde omvat octetten in unicast-, broadcast- en multicastpakketten.InUcastPkts
Het aantal unicastpakketten dat zonder fouten wordt ontvangen via deze interface.InNUcastPkts
Het aantal niet-unicastpakketten dat zonder fouten wordt ontvangen via deze interface. Deze waarde omvat broadcast- en multicastpakketten.InDiscards
Het aantal binnenkomende pakketten dat is verwijderd, ook al hebben ze geen fouten.InErrors-
Het aantal binnenkomende pakketten dat is verwijderd vanwege fouten.InUnknownProtos-
Het aantal binnenkomende pakketten dat is verwijderd omdat het protocol onbekend is.InUcastOctets-
Het aantal octetten met gegevens die zonder fouten in unicastpakketten worden ontvangen via deze interface.InMulticastOctets-
Het aantal octetten met gegevens die zonder fouten in multicastpakketten worden ontvangen via deze interface.InBroadcastOctets
Het aantal octetten met gegevens die worden ontvangen zonder fouten in broadcastpakketten via deze interface.OutOctets
Het aantal octetten met gegevens dat zonder fouten via deze interface wordt verzonden. Deze waarde omvat octetten in unicast-, broadcast- en multicastpakketten.OutUcastPkts
Het aantal unicastpakketten dat zonder fouten via deze interface wordt verzonden.OutNUcastPkts
Het aantal niet-unicastpakketten dat zonder fouten via deze interface wordt verzonden. Deze waarde omvat broadcast- en multicastpakketten.OutDiscards
Het aantal uitgaande pakketten dat is verwijderd, ook al hebben ze geen fouten.OutErrors
Het aantal uitgaande pakketten dat is verwijderd vanwege fouten.OutUcastOctets
Het aantal octetten met gegevens dat zonder fouten in unicastpakketten via deze interface wordt verzonden.OutMulticastOctets-
Het aantal octetten met gegevens dat zonder fouten in multicastpakketten via deze interface wordt verzonden.OutBroadcastOctets
Het aantal octetten met gegevens die worden verzonden zonder fouten in broadcastpakketten via deze interface.OutQLen-
De lengte van de verzendwachtrij. Dit veld wordt momenteel niet gebruikt.
Opmerkingen
De waarden voor het veld Type worden gedefinieerd in het headerbestand Ipifcons.h. Alleen de mogelijke waarden die worden vermeld in de beschrijving van het typelid, worden momenteel ondersteund.
Eisen
Versie |
Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen. |
Rubriek |
Netioapi.h (inclusief Netioapi.h) |