次の方法で共有

MIB_IFROW構造体 (ifmib.h)

  • [アーティクル]

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

構文

typedef struct _MIB_IFROW {
  WCHAR                   wszName[MAX_INTERFACE_NAME_LEN];
  IF_INDEX                dwIndex;
  IFTYPE                  dwType;
  DWORD                   dwMtu;
  DWORD                   dwSpeed;
  DWORD                   dwPhysAddrLen;
  UCHAR                   bPhysAddr[MAXLEN_PHYSADDR];
  DWORD                   dwAdminStatus;
  INTERNAL_IF_OPER_STATUS dwOperStatus;
  DWORD                   dwLastChange;
  DWORD                   dwInOctets;
  DWORD                   dwInUcastPkts;
  DWORD                   dwInNUcastPkts;
  DWORD                   dwInDiscards;
  DWORD                   dwInErrors;
  DWORD                   dwInUnknownProtos;
  DWORD                   dwOutOctets;
  DWORD                   dwOutUcastPkts;
  DWORD                   dwOutNUcastPkts;
  DWORD                   dwOutDiscards;
  DWORD                   dwOutErrors;
  DWORD                   dwOutQLen;
  DWORD                   dwDescrLen;
  UCHAR                   bDescr[MAXLEN_IFDESCR];
} MIB_IFROW, *PMIB_IFROW;

メンバー

wszName[MAX_INTERFACE_NAME_LEN]

種類: WCHAR[MAX_INTERFACE_NAME_LEN]

インターフェイスの名前を含む Unicode 文字列へのポインター。

dwIndex

型: DWORD

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

dwType

型: DWORD

インターネット割り当て名機関 (IANA) によって定義されたインターフェイス型。 詳細については、「http://www.iana.org/assignments/ianaiftype-mib」を参照してください。 インターフェイスの種類に使用できる値は、 Ipifcons.h ヘッダー ファイルに一覧表示されます。

次の表に、インターフェイス型の一般的な値を示しますが、他の多くの値を使用できます。

値 意味
IF_TYPE_OTHER
1
 その他の種類のネットワーク インターフェイス。
IF_TYPE_ETHERNET_CSMACD
6
 イーサネット ネットワーク インターフェイス。
IF_TYPE_ISO88025_TOKENRING
9
 トークン リング ネットワーク インターフェイス。
IF_TYPE_FDDI
15
 ファイバー分散データ インターフェイス (FDDI) ネットワーク インターフェイス。
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) の高性能シリアル バス ネットワーク インターフェイス。
IF_TYPE_IEEE80216_WMAN
237
 WiMax デバイス用のモバイル ブロードバンド インターフェイス。
メモ このインターフェイスの種類は、Windows 7、Windows Server 2008 R2 以降でサポートされています。
 
IF_TYPE_WWANPP
243
 GSM ベースのデバイス用のモバイル ブロードバンド インターフェイス。
メモ このインターフェイスの種類は、Windows 7、Windows Server 2008 R2 以降でサポートされています。
 
IF_TYPE_WWANPP2
244
 CDMA ベースのデバイス用のモバイル ブロードバンド インターフェイス。
メモ このインターフェイスの種類は、Windows 7、Windows Server 2008 R2 以降でサポートされています。
 

dwMtu

型: DWORD

最大伝送単位 (MTU) サイズ (バイト単位)。

dwSpeed

型: DWORD

インターフェイスの速度 (ビット/秒)。

dwPhysAddrLen

型: DWORD

bPhysAddr メンバーによって指定された物理アドレスの長さ (バイト単位)。

bPhysAddr[MAXLEN_PHYSADDR]

型: BYTE[MAXLEN_PHYSADDR]

このインターフェイスのアダプターの物理アドレス。

dwAdminStatus

型: DWORD

インターフェイスが管理上有効または無効になっています。

dwOperStatus

型: DWORD

インターフェイスの動作状態。 このメンバーには、 Ipifcons.h ヘッダー ファイルで定義されているINTERNAL_IF_OPER_STATUS列挙で定義されている次のいずれかの値を指定できます。

値 意味
IF_OPER_STATUS_NON_OPERATIONAL
 LAN アダプターが無効になっています。たとえば、アドレスの競合が原因です。
IF_OPER_STATUS_UNREACHABLE
 接続されていない WAN アダプター。
IF_OPER_STATUS_DISCONNECTED
 LAN アダプターの場合: ネットワーク ケーブルが切断されています。 WAN アダプターの場合: 通信事業者なし。
IF_OPER_STATUS_CONNECTING
 接続中の WAN アダプター。
IF_OPER_STATUS_CONNECTED
 リモート ピアに接続されている WAN アダプター。
IF_OPER_STATUS_OPERATIONAL
 LAN アダプターの既定の状態

dwLastChange

型: DWORD

インターフェイスが現在の動作状態になったときの、最後のコンピューターの再起動から開始する 100 分の 1 秒 (10^-2 秒) の長さ。 この値は、2^3200 秒後にロールオーバーされます。

dwLastChange メンバーは、現在 NDIS ではサポートされていません。 Windows Vista 以降では、NDIS はこのメンバーの 0 を返します。 以前のバージョンの Windows では、NDIS でサポートされているインターフェイスに対して、このメンバーに任意の値が返されます。 他のインターフェイス プロバイダーでサポートされているインターフェイスの場合、適切な値が返される場合があります。

dwInOctets

型: DWORD

このインターフェイスを介して受信したデータのオクテットの数。

dwInUcastPkts

型: DWORD

このインターフェイスを介して受信したユニキャスト パケットの数。

dwInNUcastPkts

型: DWORD

このインターフェイスを介して受信された非ユニキャスト パケットの数。 ブロードキャスト パケットとマルチキャスト パケットが含まれます。

dwInDiscards

型: DWORD

エラーがない場合でも破棄された受信パケットの数。

dwInErrors

型: DWORD

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

dwInUnknownProtos

型: DWORD

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

dwOutOctets

型: DWORD

このインターフェイスを介して送信されるデータのオクテットの数。

dwOutUcastPkts

型: DWORD

このインターフェイスを介して送信されるユニキャスト パケットの数。

dwOutNUcastPkts

型: DWORD

このインターフェイスを介して送信される非ユニキャスト パケットの数。 ブロードキャスト パケットとマルチキャスト パケットが含まれます。

dwOutDiscards

型: DWORD

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

dwOutErrors

型: DWORD

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

dwOutQLen

型: DWORD

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

dwDescrLen

型: DWORD

bDescr メンバーの長さ (バイト単位)。

bDescr[MAXLEN_IFDESCR]

型: BYTE[MAXLEN_IFDESCR]

インターフェイスの説明。

注釈

DWORD に格納できる最大値は 4,294,967,295 であるため、MIB_IFROW構造体のdwSpeed メンバーは、非常に高速なネットワーク インターフェイス (10 Gbit/s ネットワーク アダプターなど) では正しくありません。 アプリケーションでは、GetIfEntry2 関数と GetIfTable2 関数によって返されるMIB_IF_ROW2構造、または GetAdaptersAddresses 関数によって返されるIP_ADAPTER_ADDRESSES構造体を使用して、非常に高速なネットワーク インターフェイスの速度を決定する必要があります。

Windows Vista 以降用にリリースされた Microsoft Windows ソフトウェア開発キット (Windows SDK) (SDK) では、ヘッダー ファイルのorganizationが変更され、MIB_IFROW構造は Iprtrmib.h ヘッダー ファイルではなく Ifmib.h ヘッダー ファイルで定義されます。 Ifmib.h ヘッダー ファイルは、Iphlpapi.h ヘッダー ファイルに自動的に含まれる Iprtrmib.h に自動的に含まれることに注意してください。 Ifmib.h および Iprtrmib.h ヘッダー ファイルを直接使用しないでください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header ifmib.h (Iphlpapi.h を含む)

こちらもご覧ください

GetAdaptersAddresses

GetIfEntry

GetIfEntry2

IP_ADAPTER_ADDRESSES

MIB_IFSTATUS

MIB_IFTABLE

MIB_IF_TABLE2

MPR_INTERFACE_0