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 ヘッダー ファイルに一覧表示されます。

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

dwMtu

型: DWORD

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

dwSpeed

型: DWORD

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

dwPhysAddrLen

型: DWORD

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

bPhysAddr[MAXLEN_PHYSADDR]

型: BYTE[MAXLEN_PHYSADDR]

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

dwAdminStatus

型: DWORD

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

dwOperStatus

型: DWORD

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

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 ヘッダー ファイルを直接使用しないでください。

要件

こちらもご覧ください

GetAdaptersAddresses

GetIfEntry

GetIfEntry2

IP_ADAPTER_ADDRESSES

MIB_IFSTATUS

MIB_IFTABLE

MIB_IF_TABLE2

MPR_INTERFACE_0