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 ヘッダー ファイルを直接使用しないでください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | ifmib.h (Iphlpapi.h を含む) |