MIB_IF_ROW2 構造体

MIB_IF_ROW2 構造体には、特定のインターフェイスに関する情報が格納されます。

構文

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;

メンバー

  • InterfaceLuid
    ネットワーク インターフェイスのローカル一意識別子 (LUID)。

  • InterfaceIndex
    ネットワーク インターフェイスを識別するインデックス。 このインデックス値は、ネットワーク アダプターを無効にしてから有効にすると変更される可能性があり、永続的と見なすべきではありません。

  • InterfaceGuid
    ネットワーク インターフェイスの GUID。

  • エイリアス
    ネットワーク インターフェイスの別名を含む、NULL で終わる Unicode 文字列。

  • 説明
    ネットワーク インターフェイスの説明を含む、NULL で終わる Unicode 文字列。

  • PhysicalAddressLength
    PhysicalAddress メンバーが指定する物理ハードウェア アドレスの長さ (バイト単位)。

  • PhysicalAddress
    このネットワーク インターフェイスのアダプターの物理ハードウェア アドレス。

  • PermanentPhysicalAddress
    このネットワーク インターフェイスのアダプターの永続的な物理ハードウェア アドレス。

  • Mtu
    このネットワーク インターフェイスの最大転送単位 (MTU) サイズ (バイト単位)。

  • Type
    IANA (Internet Assigned Names Authority) で定義されるインターフェイス型。 詳細については、「IANAifType-MIB の定義」を参照してください。 インターフェイス型に使用できる値は、Ipifcons.h ヘッダー ファイルに記載されています。

    次の表にインターフェイス型の一般的な値を示しますが、これ以外にも多くの値が可能です。

    意味

    IF_TYPE_OTHER

    1

    他の型のネットワーク インターフェイス

    IF_TYPE_ETHERNET_CSMACD

    6

    イーサネット ネットワーク インターフェイス

    IF_TYPE_ISO88025_TOKENRING

    9

    トークン リング ネットワーク インターフェイス

    IF_TYPE_PPP

    23

    PPP ネットワーク インターフェイス

    IF_TYPE_SOFTWARE_LOOPBACK

    24

    ソフトウェア ループバック ネットワーク インターフェイス

    IF_TYPE_ATM

    37

    ATM ネットワーク インターフェイス

    IF_TYPE_IEEE80211

    71

    IEEE 802.11 ワイヤレス ネットワーク インターフェイス

    IF_TYPE_TUNNEL

    131

    トンネル型カプセル化ネットワーク インターフェイス

    IF_TYPE_IEEE1394

    144

    IEEE 1394 (Firewire) ハイ パフォーマンス シリアル バス ネットワーク インターフェイス

  • TunnelType
    Type メンバーが IF_TYPE_TUNNEL の場合に、トンネルで使用されるカプセル化方法を定義する TUNNEL_TYPE

  • MediaType
    インターフェイスの NDIS メディアの種類。 このメンバーには、Ntddndis.h ヘッダー ファイルで定義されている NDIS_MEDIUM 列挙型の次のいずれかの値を指定できます。

    意味

    NdisMedium802_3

    0

    イーサネット (802.3) ネットワーク。

    NdisMedium802_5

    1

    トークン リング (802.5) ネットワーク。

    NdisMediumFddi

    2

    FDDI (Fiber Distributed Data Interface) ネットワーク。

    NdisMediumWan

    3

    ワイド エリア ネットワーク (WAN)。 この型は、バインディングの確立後にプロトコル ドライバーと基になるドライバーの間でネゴシエートする必要がある、さまざまな形式のポイントツーポイントや WAN の NIC、および異なるアドレス/ヘッダー形式をカバーします。

    NdisMediumLocalTalk

    4

    LocalTalk ネットワーク。

    NdisMediumDix

    5

    ドライバーが DIX イーサネット ヘッダー形式を使用するイーサネット ネットワーク。

    NdisMediumArcnetRaw

    6

    ARCNET ネットワーク。

    NdisMediumArcnet878_2

    7

    ARCNET (878.2) ネットワーク。

    NdisMediumAtm

    8

    ATM ネットワーク。 接続指向のクライアント プロトコル ドライバーは、この値を返す基になるミニポート ドライバーに自身をバインドできます。 そうでなければ、レガシ プロトコル ドライバーは、システム提供の LanE 中間ドライバーに自身をバインドし、ネットワーク管理者が LanE ドライバーをどのように構成するかに応じて、そのメディアの種類を NdisMedium802_3 または NdisMedium802_5 として報告します。

    NdisMediumWirelessWan

    9

    ワイヤレス ネットワーク。 NDIS 5. x ミニポート ドライバー (ワイヤレス LAN (WLAN) パケットまたはワイヤレス WAN (WWAN) パケットをサポート) は、そのメディアを NdisMedium802_3 として宣言し、上位の NDIS ドライバーにイーサネットをエミュレートします。

    このメディアの種類は、Windows Vista 以降のバージョンの Windows では使用できないことにご注意ください。

    NdisMediumIrda

    10

    赤外線 (IrDA) ネットワーク。

    NdisMediumBpc

    11

    ブロードキャスト コンピューター ネットワーク。

    NdisMediumCoWan

    12

    接続指向環境のワイド エリア ネットワーク。

    NdisMedium1394

    13

    IEEE 1394 (Firewire) ネットワーク。

    NdisMediumInfiniBand

    14

    InfiniBand ネットワーク。

    NdisMediumTunnel

    15

    トンネル ネットワーク。

    NdisMediumNative802_11

    16

    ネイティブ IEEE 802.11 ネットワーク。

    NdisMediumLoopback

    17

    NDIS ループバック ネットワーク。

  • PhysicalMediumType
    NDIS 物理メディアの種類。 このメンバーには、Ntddndis.h ヘッダー ファイルで定義されている NDIS_PHYSICAL_MEDIUM 列挙型の次のいずれかの値を指定できます。

    意味

    NdisPhysicalMediumUnspecified

    0

    物理メディアは、次のいずれの値でもありません。 たとえば、一方向の衛星配信が未指定の物理メディアの場合です。

    NdisPhysicalMediumWirelessLan

    1

    パケットは、802.11 インターフェイスに準拠するミニポート ドライバーを介してワイヤレス LAN ネットワーク経由で転送されます。

    NdisPhysicalMediumCableModem

    2

    パケットは DOCSIS ベースのケーブル ネットワーク経由で転送されます。

    NdisPhysicalMediumPhoneLine

    3

    パケットは標準の電話回線で転送されます。 この種類には HomePNA メディアが含まれます。

    NdisPhysicalMediumPowerLine

    4

    パケットは、配電システムに接続されている配線を介して転送されます。

    NdisPhysicalMediumDSL

    5

    パケットは、デジタル加入者回線 (DSL) ネットワーク経由で転送されます。 この種類には、ADSL、UADSL (G.Lite)、および SDSL が含まれます。

    NdisPhysicalMediumFibreChannel

    6

    パケットはファイバー チャネル相互接続を介して転送されます。

    NdisPhysicalMedium1394

    7

    パケットは IEEE 1394 バス経由で転送されます。

    NdisPhysicalMediumWirelessWan

    8

    パケットはワイヤレス WAN リンクを介して転送されます。 この種類には、CDPD、CDMA、GPRS が含まれます。

    NdisPhysicalMediumNative802_11

    9

    パケットは、ネイティブ 802.11 インターフェイスに準拠するミニポート ドライバーを介してワイヤレス LAN ネットワーク経由で転送されます。

    ネイティブ 802.11 インターフェイスは、NDIS 6.0 以降のバージョンでサポートされていることにご注意ください。

    NdisPhysicalMediumBluetooth

    10

    パケットは Bluetooth ネットワーク経由で転送されます。 Bluetooth とは、2.4 GHz スペクトルを使用する短距離ワイヤレス テクノロジです。

    NdisPhysicalMediumInfiniband

    11

    パケットは InfiniBand 相互接続経由で転送されます。

    NdisPhysicalMediumUWB

    13

    パケットは、超ワイドバンド ネットワーク経由で転送されます。

    NdisPhysicalMedium802_3

    14

    パケットはイーサネット (802.3) ネットワーク経由で転送されます。

    NdisPhysicalMedium802_5

    15

    パケットはトークン リング (802.5) ネットワーク経由で転送されます。

    NdisPhysicalMediumIrda

    16

    パケットは赤外線 (IrDA) ネットワーク経由で転送されます。

    NdisPhysicalMediumWiredWAN

    17

    パケットは 有線 WAN ネットワーク経由で転送されます。

    NdisPhysicalMediumWiredCoWan

    18

    パケットは、接続指向環境でワイド エリア ネットワーク経由で転送されます。

    NdisPhysicalMediumOther

    19

    パケットは、他の可能な値で記述されていないネットワーク経由で転送されます。

  • AccessType
    NET_IF_ACCESS_TYPE NDIS ネットワーク インターフェイス アクセスの種類。

  • DirectionType
    NET_IF_DIRECTION_TYPE NDIS ネットワーク インターフェイスの方向の種類。

  • InterfaceAndOperStatusFlags
    インターフェイスに関する情報を提供する次のフラグのセット。 これらのフラグは、ビットごとの OR 演算と組み合わされます。 どのフラグも適用されない場合、このメンバーは 0 に設定されます。

    • HardwareInterface
      このネットワーク インターフェイスはハードウェア用です。

    • FilterInterface
      このネットワーク インターフェイスはフィルター モジュール用です。

    • ConnectorPresent
      コネクタがネットワーク インターフェイス上にあります。 この値は、物理ネットワーク アダプターがある場合に設定されます。

    • NotAuthenticated
      ネットワーク インターフェイスの既定のポートは認証されません。 ネットワーク インターフェイスがターゲットによって認証されていない場合、ネットワーク インターフェイスは操作モードではありません。 この状況は有線ネットワーク接続とワイヤレス ネットワーク接続の両方に適用されますが、認証はワイヤレス ネットワーク接続のほうがより一般的です。

    • NotMediaConnected
      ネットワーク インターフェイスは、メディアに接続された状態ではありません。 有線ネットワークのネットワーク ケーブルが取り外されていると、この値が設定されます。 ワイヤレス ネットワークの場合、この値は、ネットワークに接続されていないネットワーク アダプターに対して設定されます。

    • 一時停止
      ネットワーク インターフェイスのネットワーク スタックが、一時停止状態または一時停止中の状態です。 この値は、コンピューターが休止状態であることを意味するものではありません。

    • LowPower
      ネットワーク インターフェイスが低電力状態です。

    • EndPointInterface
      ネットワーク インターフェイスはエンドポイント デバイスであり、ネットワークに接続する真のネットワーク インターフェイスではありません。 この値は、ネットワーク インフラストラクチャを使用してコンピューターと通信はするものの、外部ネットワークへの接続は提供しないデバイス (スマートフォンなど) で設定できます。 これらの種類のデバイスでは、このフラグを設定する必要があります。

  • OperStatus
    IF_OPER_STATUS NDIS ネットワーク インターフェイスの操作状態の種類。

  • AdminStatus
    NET_IF_ADMIN_STATUS 管理状態の種類。

  • MediaConnectState
    NET_IF_MEDIA_CONNECT_STATE 接続状態の種類。

  • NetworkGuid
    インターフェイスが属するネットワークに関連付けられている GUID。

  • ConnectionType
    NET_IF_CONNECTION_TYPE NDIS ネットワーク インターフェイス接続の種類。

  • TransmitLinkSpeed
    送信リンクの速度 (1 秒あたりのビット数)。

  • ReceiveLinkSpeed
    受信リンクの速度 (1 秒あたりのビット数)。

  • InOctets
    このインターフェイスを介してエラーなしで受信されるデータのオクテットの数。 この値には、ユニキャスト パケット、ブロードキャスト パケット、およびマルチキャスト パケットのオクテットが含まれます。

  • InUcastPkts
    このインターフェイスを介してエラーなしで受信されるユニキャスト パケットの数。

  • InNUcastPkts
    このインターフェイスを介してエラーなしで受信されるユニキャスト以外のパケットの数。 この値には、ブロードキャスト パケットとマルチキャスト パケットが含まれます。

  • InDiscards
    エラーがないにもかかわらず破棄された受信パケットの数。

  • InErrors
    エラーが原因で破棄された受信パケットの数。

  • InUnknownProtos
    プロトコルが不明であったために破棄された受信パケットの数。

  • InUcastOctets
    このインターフェイスを介してユニキャスト パケットでエラーなしで受信されたデータのオクテットの数。

  • InMulticastOctets
    このインターフェイスを介してマルチキャスト パケットでエラーなしで受信されたデータのオクテットの数。

  • InBroadcastOctets
    このインターフェイスを介してブロードキャスト パケットでエラーなしで受信されたデータのオクテットの数。

  • OutOctets
    このインターフェイスを介してエラーなしで伝送されるデータのオクテットの数。 この値には、ユニキャスト パケット、ブロードキャスト パケット、およびマルチキャスト パケットのオクテットが含まれます。

  • OutUcastPkts
    このインターフェイスを介してエラーなしで伝送されるユニキャスト パケットの数。

  • OutNUcastPkts
    このインターフェイスを介してエラーなしで伝送されるユニキャスト以外のパケットの数。 この値には、ブロードキャスト パケットとマルチキャスト パケットが含まれます。

  • OutDiscards
    エラーがないにもかかわらず破棄された送信パケットの数。

  • OutErrors
    エラーが原因で破棄された送信パケットの数。

  • OutUcastOctets
    このインターフェイスを介してユニキャスト パケットでエラーなしで伝送されたデータのオクテットの数。

  • OutMulticastOctets
    このインターフェイスを介してマルチキャスト パケットでエラーなしで伝送されたデータのオクテットの数。

  • OutBroadcastOctets
    このインターフェイスを介してブロードキャスト パケットでエラーなしで伝送されたデータのオクテットの数。

  • OutQLen
    伝送キューの長さ。 このフィールドは現在使用されていません。

解説

[種類] フィールドの値は、Ipifcons.h ヘッダー ファイルで定義されています。 Type メンバーの説明に記載されている使用可能な値のみが現在サポートされています。

要件

バージョン

Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。

ヘッダー

Netioapi.h (Netioapi.h を含む)

関連項目

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