Udostępnij przez


struktura MIB_IF_ROW2

Struktura MIB_IF_ROW2 przechowuje informacje o określonym interfejsie.

Składnia

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;

Członków

  • InterfaceLuid
    Lokalnie unikatowy identyfikator (LUID) dla interfejsu sieciowego.

  • InterfaceIndex
    Indeks identyfikujący interfejs sieciowy. Ta wartość indeksu może ulec zmianie, gdy karta sieciowa jest wyłączona, a następnie włączona i nie powinna być uważana za trwałą.

  • InterfaceGuid
    Identyfikator GUID interfejsu sieciowego.

  • alias
    Ciąg Unicode zakończony wartością NULL, który zawiera nazwę aliasu interfejsu sieciowego.

  • opis
    Ciąg Unicode zakończony wartością NULL, który zawiera opis interfejsu sieciowego.

  • PhysicalAddressLength
    Długość w bajtach fizycznego adresu sprzętowego określonego przez element członkowski PhysicalAddress.

  • PhysicalAddress
    Fizyczny adres sprzętowy karty dla tego interfejsu sieciowego.

  • PermanentPhysicalAddress
    Stały fizyczny adres karty sieciowej.

  • Mtu
    Maksymalny rozmiar jednostki transmisji (MTU) w bajtach dla tego interfejsu sieciowego.

  • typu
    Typ interfejsu zdefiniowany przez urząd IANA (Internet Assigned Names Authority). Aby uzyskać więcej informacji, zobacz IANAifType-MIB DEFINITIONS. Możliwe wartości dla typu interfejsu są wymienione w pliku nagłówka Ipifcons.h.

    W poniższej tabeli wymieniono typowe wartości typu interfejsu, chociaż istnieje wiele innych wartości.

    Wartość Znaczenie

    IF_TYPE_OTHER

    1

    Inny typ interfejsu sieciowego

    IF_TYPE_ETHERNET_CSMACD

    6

    Interfejs sieciowy Ethernet

    IF_TYPE_ISO88025_TOKENRING

    9

    Interfejs sieciowy pierścienia tokenów

    IF_TYPE_PPP

    23

    Interfejs sieciowy PPP

    IF_TYPE_SOFTWARE_LOOPBACK

    24

    Interfejs sieciowy sprzężenia zwrotnego oprogramowania

    IF_TYPE_ATM

    37

    Interfejs sieciowy usługi ATM

    IF_TYPE_IEEE80211

    71

    Interfejs sieciowy IEEE 802.11

    IF_TYPE_TUNNEL

    131

    Interfejs sieciowy hermetyzacji typu tunelu

    IF_TYPE_IEEE1394

    144

    Interfejs sieciowy magistrali szeregowej IEEE 1394 (Firewire) o wysokiej wydajności

  • TunnelType
    Jeśli element członkowski typu jest IF_TYPE_TUNNEL, typ TUNNEL_TYPE definiujący metodę hermetyzacji używaną przez tunel.

  • MediaType
    Typ nośnika NDIS dla interfejsu. Ten element członkowski może być jedną z następujących wartości z NDIS_MEDIUM typu wyliczenia zdefiniowanego w pliku nagłówka Ntddndis.h.

    Wartość Znaczenie

    NdisMedium802_3

    0

    Sieć Ethernet (802.3).

    NdisMedium802_5

    1

    Sieć pierścienia tokenów (802.5).

    NdisMediumFddi

    2

    Sieć FDDI (Fiber Distributed Data Interface).

    NdisMediumWan

    3

    Sieć rozległa (WAN). Ten typ obejmuje różne formy kart sieciowych punkt-punkt i WAN oraz formaty adresów/nagłówków wariantów, które muszą być negocjowane między sterownikiem protokołu a podstawowym sterownikiem po ustanowieniu powiązania.

    NdisMediumLocalTalk

    4

    Sieć LocalTalk.

    NdisMediumDix

    5

    Sieć Ethernet, dla której sterowniki używają formatu nagłówka DIX Ethernet.

    NdisMediumArcnetRaw

    6

    Sieć ARCNET.

    NdisMediumArcnet878_2

    7

    Sieć ARCNET (878.2).

    NdisMediumAtm

    8

    Sieć atm. Sterowniki protokołu klienta zorientowanego na połączenie mogą powiązać się z bazowym sterownikiem miniportu, który zwraca tę wartość. W przeciwnym razie starsze sterowniki protokołów wiążą się z dostarczonym przez system sterownikiem pośrednim LanE, który zgłasza swój średni typ jako NdisMedium802_3 lub NdisMedium802_5, w zależności od tego, jak administrator sieci konfiguruje sterownik LanE.

    NdisMediumWirelessWan

    9

    Sieć bezprzewodowa. NDIS 5. x sterowniki miniportów, które obsługują bezprzewodowe pakiety SIECI LAN (WLAN) lub bezprzewodowej sieci WAN (WWAN) deklarują ich medium jako NdisMedium802_3 i emulują Ethernet do sterowników NDIS wyższego poziomu.

    Uwaga Ten typ nośnika nie jest dostępny do użycia w systemie Windows Vista lub nowszych wersjach systemu Windows.

    NdisMediumIrda

    10

    Sieć podczerwieni (IrDA).

    NdisMediumBpc

    11

    Sieć komputerów rozgłaszanych.

    NdisMediumCoWan

    12

    Sieć rozległa w środowisku zorientowanym na połączenie.

    NdisMedium1394

    13

    Sieć IEEE 1394 (przewody pożarowe).

    NdisMediumInfiniBand

    14

    Sieć InfiniBand.

    NdisMediumTunnel

    15

    Sieć tunelu.

    NdisMediumNative802_11

    16

    Natywna sieć IEEE 802.11.

    NdisMediumLoopback

    17

    Sieć sprzężenia zwrotnego NDIS.

  • PhysicalMediumType
    Typ nośnika fizycznego NDIS. Ten element członkowski może być jedną z następujących wartości z NDIS_PHYSICAL_MEDIUM typu wyliczenia zdefiniowanego w pliku nagłówka Ntddndis.h.

    Wartość Znaczenie

    NdisPhysicalMediumUnspecified

    0

    Nośnik fizyczny nie jest żadną z następujących wartości. Na przykład jednokierunkowe źródło satelitarne jest nieokreślonym nośnikiem fizycznym.

    NdisPhysicalMediumWirelessLan

    1

    Pakiety są przesyłane za pośrednictwem sieci bezprzewodowej LAN za pośrednictwem sterownika miniportu, który jest zgodny z interfejsem 802.11.

    NdisPhysicalMediumCableModem

    2

    Pakiety są przesyłane za pośrednictwem sieci kablowej opartej na usłudze DOCSIS.

    NdisPhysicalMediumPhoneLine

    3

    Pakiety są przesyłane za pośrednictwem standardowych linii telefonicznych. Ten typ obejmuje nośnik HomePNA.

    NdisPhysicalMediumPowerLine

    4

    Pakiety są przesyłane przez okablowanie połączone z systemem dystrybucji zasilania.

    NdisPhysicalMediumDSL

    5

    Pakiety są przesyłane za pośrednictwem sieci cyfrowej linii subskrybentów (DSL). Ten typ obejmuje ADSL, UADSL (G.Lite) i SDSL.

    NdisPhysicalMediumFibreChannel

    6

    Pakiety są przesyłane za pośrednictwem połączenia między protokołem Fibre Channel.

    NdisPhysicalMedium1394

    7

    Pakiety są przesyłane przez magistralę IEEE 1394.

    NdisPhysicalMediumWirelessWan

    8

    Pakiety są przesyłane za pośrednictwem bezprzewodowego łącza sieci WAN. Ten typ obejmuje CDPD, CDMA i GPRS.

    NdisPhysicalMediumNative802_11

    9

    Pakiety są przesyłane za pośrednictwem sieci bezprzewodowej LAN za pośrednictwem sterownika miniportu, który jest zgodny z interfejsem Native 802.11.

    Uwaga Natywny interfejs 802.11 jest obsługiwany w usłudze NDIS 6.0 i nowszych wersjach.

    NdisPhysicalMediumBluetooth

    10

    Pakiety są przesyłane za pośrednictwem sieci Bluetooth. Bluetooth to technologia bezprzewodowa o krótkim zasięgu, która wykorzystuje spektrum 2,4 GHz.

    NdisPhysicalMediumInfiniband

    11

    Pakiety są przesyłane za pośrednictwem połączenia infiniBand.

    NdisPhysicalMediumUWB

    13

    Pakiety są przesyłane za pośrednictwem sieci ultrapasmowej.

    NdisPhysicalMedium802_3

    14

    Pakiety są przesyłane za pośrednictwem sieci Ethernet (802.3).

    NdisPhysicalMedium802_5

    15

    Pakiety są przesyłane za pośrednictwem sieci Token Ring (802.5).

    NdisPhysicalMediumIrda

    16

    Pakiety są przesyłane za pośrednictwem sieci podczerwieni (IrDA).

    NdisPhysicalMediumWiredWAN

    17

    Pakiety są przesyłane za pośrednictwem sieci przewodowej WAN.

    NdisPhysicalMediumWiredCoWan

    18

    Pakiety są przesyłane za pośrednictwem sieci rozległej w środowisku zorientowanym na połączenie.

    NdisPhysicalMediumInne

    19

    Pakiety są przesyłane za pośrednictwem sieci, która nie jest opisana przez inne możliwe wartości.

  • AccessType
    Typ dostępu do interfejsu sieciowego NDIS NET_IF_ACCESS_TYPE.

  • DirectionType
    Typ kierunku interfejsu sieciowego NDIS NET_IF_DIRECTION_TYPE.

  • InterfaceAndOperStatusFlags
    Zestaw następujących flag, które zawierają informacje o interfejsie. Te flagi są łączone z bitową operacją OR. Jeśli żadna z flag nie ma zastosowania, ten element członkowski ma wartość zero.

    • HardwareInterface
      Interfejs sieciowy jest przeznaczony dla sprzętu.

    • FilterInterface
      Interfejs sieciowy jest przeznaczony dla modułu filtru.

    • ConnectorPresent
      Łącznik jest obecny w interfejsie sieciowym. Ta wartość jest ustawiana, jeśli istnieje fizyczna karta sieciowa.

    • nieuwierzytelnione
      Domyślny port interfejsu sieciowego nie jest uwierzytelniany. Jeśli interfejs sieciowy nie jest uwierzytelniany przez obiekt docelowy, interfejs sieciowy nie jest w trybie operacyjnym. Chociaż ta sytuacja ma zastosowanie zarówno do połączeń przewodowych, jak i bezprzewodowych, uwierzytelnianie jest bardziej powszechne w przypadku połączeń sieci bezprzewodowej.

    • NotMediaConnected
      Interfejs sieciowy nie jest w stanie połączonym z nośnikiem. Jeśli sieciowy jest odłączony od sieci przewodowej, ta wartość jest ustawiona. W przypadku sieci bezprzewodowej ta wartość jest ustawiona dla karty sieciowej, która nie jest połączona z siecią.

    • Wstrzymano
      Stos sieciowy interfejsu sieciowego jest w stanie wstrzymania lub wstrzymania. Ta wartość nie oznacza, że komputer jest w stanie hibernacji.

    • LowPower
      Interfejs sieciowy jest w stanie niskim zasilania.

    • EndPointInterface
      Interfejs sieciowy to urządzenie punktu końcowego, a nie prawdziwy interfejs sieciowy, który łączy się z siecią. Tę wartość można ustawić za pomocą urządzeń, takich jak smartfony, które używają infrastruktury sieciowej do komunikowania się z komputerem, ale nie zapewniają łączności z siecią zewnętrzną. Tego typu urządzenia muszą ustawić tę flagę.

  • OperStatus
    Typ stanu operacyjnego interfejsu sieciowego NDIS IF_OPER_STATUS.

  • AdminStatus
    Typ stanu administracyjnego NET_IF_ADMIN_STATUS.

  • MediaConnectState
    Typ stanu połączenia NET_IF_MEDIA_CONNECT_STATE.

  • NetworkGuid
    Identyfikator GUID skojarzony z siecią, do którego należy interfejs.

  • ConnectionType
    Typ połączenia interfejsu sieciowego NDIS NET_IF_CONNECTION_TYPE.

  • TransmitLinkSpeed
    Szybkość, w bitach na sekundę, łącza transmisji.

  • ReceiveLinkSpeed
    Szybkość w bitach na sekundę łącza odbioru.

  • InOctets
    Liczba oktetów danych, które są odbierane bez błędów za pośrednictwem tego interfejsu. Ta wartość obejmuje oktety w pakietach emisji pojedynczej, emisji i multiemisji.

  • InUcast
    Liczba pakietów emisji pojedynczej, które są odbierane bez błędów za pośrednictwem tego interfejsu.

  • InNUcast
    Liczba pakietów emisji niezwiązanych z emisją pojedynczą, które są odbierane bez błędów za pośrednictwem tego interfejsu. Ta wartość obejmuje pakiety emisji i multiemisji.

  • InDiscards
    Liczba pakietów przychodzących, które zostały odrzucone, mimo że nie miały błędów.

  • InErrors
    Liczba pakietów przychodzących, które zostały odrzucone z powodu błędów.

  • InUnknownProtos
    Liczba pakietów przychodzących, które zostały odrzucone, ponieważ protokół był nieznany.

  • InUcastOctets
    Liczba oktetów danych, które są odbierane bez błędów w pakietach emisji pojedynczej za pośrednictwem tego interfejsu.

  • InMulticastOctets
    Liczba oktetów danych, które są odbierane bez błędów w pakietach multiemisji za pośrednictwem tego interfejsu.

  • InBroadcastOctets
    Liczba oktetów danych, które są odbierane bez błędów w pakietach rozgłaszanych za pośrednictwem tego interfejsu.

  • outOctets
    Liczba oktetów danych przesyłanych bez błędów za pośrednictwem tego interfejsu. Ta wartość obejmuje oktety w pakietach emisji pojedynczej, emisji i multiemisji.

  • OutUcastPkts
    Liczba pakietów emisji pojedynczej, które są przesyłane bez błędów za pośrednictwem tego interfejsu.

  • OutNUcastPkts
    Liczba pakietów emisji niezwiązanych z emisją pojedynczą, które są przesyłane bez błędów za pośrednictwem tego interfejsu. Ta wartość obejmuje pakiety emisji i multiemisji.

  • OutDiscards
    Liczba pakietów wychodzących, które zostały odrzucone, mimo że nie miały błędów.

  • OutErrors
    Liczba pakietów wychodzących, które zostały odrzucone z powodu błędów.

  • OutUcastOctets
    Liczba oktetów danych przesyłanych bez błędów w pakietach emisji pojedynczej za pośrednictwem tego interfejsu.

  • OutMulticastOctets
    Liczba oktetów danych przesyłanych bez błędów w pakietach multiemisji za pośrednictwem tego interfejsu.

  • OutBroadcastOctets
    Liczba oktetów danych przesyłanych bez błędów w pakietach rozgłaszanych za pośrednictwem tego interfejsu.

  • OutQLen
    Długość kolejki transmisji. To pole nie jest obecnie używane.

Uwagi

Wartości pola Typ są definiowane w pliku nagłówkowym Ipifcons.h. Obecnie obsługiwane są tylko możliwe wartości wymienione w opisie elementu członkowskiego typu.

Wymagania

Wersja

Dostępne w systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows.

Nagłówek

Netioapi.h (include Netioapi.h)

Zobacz też

GetIfEntry2

GetIfTable2

MIB_IF_TABLE2

NET_IF_ACCESS_TYPE

NET_IF_ADMIN_STATUS

NET_IF_CONNECTION_TYPE

NET_IF_DIRECTION_TYPE

NET_IF_MEDIA_CONNECT_STATE

NET_LUID

TUNNEL_TYPE