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 を含む) |