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) サイズ (バイト単位)。型の
インターネット割り当て名機関 (IANA) で定義されているインターフェイスの種類。 詳細については、「IANAifType-MIB DEFINITIONS」を参照してください。 インターフェイスの種類に使用できる値は、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) ネットワーク。
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。 ワイヤレス LAN (WLAN) またはワイヤレス WAN (WWAN) パケットをサポートする x ミニポート ドライバーは、そのメディアを NdisMedium802_3 として宣言し、上位レベルの NDIS ドライバーにイーサネットをエミュレートします。
注: このメディアの種類は、Windows Vista 以降のバージョンの Windows では使用できません。
NdisMediumIrda
10
赤外線 (IrDA) ネットワーク。
NdisMediumBpc
11
ブロードキャスト コンピューター ネットワーク。
NdisMediumCoWan
12
接続指向環境のワイド エリア ネットワーク。
NdisMedium1394
13
IEEE 1394 (ファイア ワイヤ) ネットワーク。
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 秒あたりのビット数)。inoctet を する
このインターフェイスを介してエラーなしで受信されるデータのオクテットの数。 この値には、ユニキャスト、ブロードキャスト、およびマルチキャスト パケットのオクテットが含まれます。inucastPkts の
このインターフェイスを介してエラーなしで受信されたユニキャスト パケットの数。InNUcastPkts の
このインターフェイスを介してエラーなしで受信された非ユニキャスト パケットの数。 この値には、ブロードキャスト パケットとマルチキャスト パケットが含まれます。InDiscards
エラーがない場合でも破棄された受信パケットの数。InErrors
エラーが原因で破棄された受信パケットの数。InUnknownProtos
プロトコルが不明であるために破棄された受信パケットの数。inucastoctets の
このインターフェイスを介してユニキャスト パケットでエラーなしで受信されたデータのオクテットの数。InMulticastOctets の
このインターフェイスを介してマルチキャスト パケットでエラーなしで受信されるデータのオクテットの数。inBroadcastOctets の
このインターフェイスを介してブロードキャスト パケットでエラーなしで受信されたデータのオクテットの数。outOctets を する
このインターフェイスを介してエラーなしで送信されるデータのオクテットの数。 この値には、ユニキャスト、ブロードキャスト、およびマルチキャスト パケットのオクテットが含まれます。outUcastPkts を する
このインターフェイスを介してエラーなしで送信されるユニキャスト パケットの数。OutNUcastPkts を する
このインターフェイスを介してエラーなしで送信される非ユニキャスト パケットの数。 この値には、ブロードキャスト パケットとマルチキャスト パケットが含まれます。OutDiscards を する
エラーがない場合でも破棄された送信パケットの数。OutErrors の
エラーが原因で破棄された送信パケットの数。OutUcastOctets の
このインターフェイスを介してユニキャスト パケットでエラーなしで送信されるデータのオクテットの数。OutMulticastOctets の
このインターフェイスを介してマルチキャスト パケットでエラーなしで送信されるデータのオクテットの数。outBroadcastOctets を する
このインターフェイスを介してブロードキャスト パケットでエラーなしで送信されるデータのオクテットの数。OutQLen を する
送信キューの長さ。 このフィールドは現在使用されていません。
備考
Type フィールドの値は、Ipifcons.h ヘッダー ファイルで定義されています。 現在、Type メンバーの説明に記載されている使用可能な値のみがサポートされています。
必要条件
バージョン |
Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダ |
Netioapi.h (Netioapi.h を含む) |
関連項目
GetIfEntry2をする
GetIfTable2をする