NDIS_INTERFACE_INFORMATION 構造体 (ifdef.h)

[アーティクル]
03/14/2023

NDIS_INTERFACE_INFORMATION構造体は、 OID_GEN_INTERFACE_INFO OID のネットワークインターフェイスに関する情報を提供します。

構文

typedef struct _NDIS_INTERFACE_INFORMATION {
  NET_IF_OPER_STATUS         ifOperStatus;
  ULONG                      ifOperStatusFlags;
  NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
  NET_IF_MEDIA_DUPLEX_STATE  MediaDuplexState;
  ULONG                      ifMtu;
  BOOLEAN                    ifPromiscuousMode;
  BOOLEAN                    ifDeviceWakeUpEnable;
  ULONG64                    XmitLinkSpeed;
  ULONG64                    RcvLinkSpeed;
  ULONG64                    ifLastChange;
  ULONG64                    ifCounterDiscontinuityTime;
  ULONG64                    ifInUnknownProtos;
  ULONG64                    ifInDiscards;
  ULONG64                    ifInErrors;
  ULONG64                    ifHCInOctets;
  ULONG64                    ifHCInUcastPkts;
  ULONG64                    ifHCInMulticastPkts;
  ULONG64                    ifHCInBroadcastPkts;
  ULONG64                    ifHCOutOctets;
  ULONG64                    ifHCOutUcastPkts;
  ULONG64                    ifHCOutMulticastPkts;
  ULONG64                    ifHCOutBroadcastPkts;
  ULONG64                    ifOutErrors;
  ULONG64                    ifOutDiscards;
  ULONG64                    ifHCInUcastOctets;
  ULONG64                    ifHCInMulticastOctets;
  ULONG64                    ifHCInBroadcastOctets;
  ULONG64                    ifHCOutUcastOctets;
  ULONG64                    ifHCOutMulticastOctets;
  ULONG64                    ifHCOutBroadcastOctets;
  NET_IF_COMPARTMENT_ID      CompartmentId;
  ULONG                      SupportedStatistics;
} NDIS_INTERFACE_INFORMATION, *PNDIS_INTERFACE_INFORMATION;

メンバー

ifOperStatus

インターフェイスの動作状態。この状態は、 OID_GEN_OPERATIONAL_STATUS OID が返す値と同じです。

ifOperStatusFlags

インターフェイスの操作状態フラグ。このフィールドは、NDIS プロキシインターフェイスプロバイダー用に予約されています。他のインターフェイスプロバイダーでは、このメンバーを 0 に設定する必要があります。

MediaConnectState

NET_IF_MEDIA_CONNECT_STATE接続状態の種類。

MediaDuplexState

インターフェイスのメディア二重状態。この状態は、 OID_GEN_MEDIA_DUPLEX_STATE OID が返す値と同じです。

ifMtu

インターフェイスの最大伝送単位 (MTU)。この MTU は、 OID_GEN_MAXIMUM_FRAME_SIZE OID が返す値と同じです。

ifPromiscuousMode

インターフェイスが無差別モードの場合は TRUE 、そうでない場合は FALSE のブール値。この値は、OID クエリが返す値 OID_GEN_PROMISCUOUS_MODE 同じです。

ifDeviceWakeUpEnable

インターフェイスが wake-on-LAN 機能をサポートし、機能が有効になっている場合は TRUE 、有効でない場合は FALSE のブール値。

XmitLinkSpeed

インターフェイスの送信リンク速度 (1 秒あたりのバイト数)。この速度は、 OID_GEN_XMIT_LINK_SPEED OID クエリが返す値と同じです。

RcvLinkSpeed

インターフェイスの受信リンク速度 (1 秒あたりのバイト数)。この速度は、 OID_GEN_RCV_LINK_SPEED OID クエリが返す値と同じです。

ifLastChange

インターフェイスが現在の操作状態に入った時刻。今回は、 OID_GEN_LAST_CHANGE OID クエリが返す値と同じです。

ifCounterDiscontinuityTime

インターフェイスのカウンターの最後の不連続の時刻。今回は、 OID_GEN_DISCONTINUITY_TIME OID クエリが返す値と同じです。

ifInUnknownProtos

インターフェイスを介して受信され、プロトコルが不明またはサポートされていないために破棄されたパケットの数。この数値は、 OID_GEN_UNKNOWN_PROTOS OID クエリが返す値と同じです。

ifInDiscards

上位層プロトコルへの配信を妨げるエラーが検出されなかった場合でも破棄された受信パケットの数。この数値は、 OID_GEN_RCV_DISCARDS OID クエリが返す値と同じです。

ifInErrors

より高い層プロトコルに配信できないエラーを含む受信パケットの数。この数値は、 OID_GEN_RCV_ERROR OID クエリが返す値と同じです。

ifHCInOctets

このインターフェイスで受信したバイトの合計数。この数値は、 OID_GEN_BYTES_RCV OID が返す値と同じです。

ifHCInUcastPkts

インターフェイスでエラーなしで受信される送信パケットの数。この数値は、 OID_GEN_DIRECTED_FRAMES_RCV OID クエリが返す値と同じです。

ifHCInMulticastPkts

インターフェイスでエラーなしで受信されるマルチキャスト/機能パケットの数。この数値は、 OID_GEN_MULTICAST_FRAMES_RCV OID クエリが返す値と同じです。

ifHCInBroadcastPkts

インターフェイスでエラーなしで受信されるブロードキャストパケットの数。この数値は、 OID_GEN_BROADCAST_FRAMES_RCV OID クエリが返す値と同じです。

ifHCOutOctets

インターフェイスでエラーなしで送信されるバイト数。この数値は、 OID_GEN_BYTES_XMIT OID クエリが返す値と同じです。

ifHCOutUcastPkts

インターフェイスでエラーなしで送信される送信パケットの数。この数値は、 OID_GEN_DIRECTED_FRAMES_XMIT OID クエリが返す値と同じです。

ifHCOutMulticastPkts

インターフェイスでエラーなしで送信されるマルチキャスト/機能パケットの数。この数値は、 OID_GEN_MULTICAST_FRAMES_XMIT OID クエリが返す値と同じです。

ifHCOutBroadcastPkts

インターフェイスでエラーなしで送信されるブロードキャストパケットの数。この数値は、 OID_GEN_BROADCAST_FRAMES_XMIT OID クエリが返す値と同じです。

ifOutErrors

インターフェイスが送信に失敗するパケットの数。この数値は、 OID_GEN_XMIT_ERROR OID クエリが返す値と同じです。

ifOutDiscards

インターフェイスが破棄するパケットの数。この数値は、 OID_GEN_XMIT_DISCARDS OID クエリが返す値と同じです。

ifHCInUcastOctets

エラーなしで受信された送信パケットのバイト数。このカウントは、 OID_GEN_DIRECTED_BYTES_RCV が返す値と同じです。

ifHCInMulticastOctets

エラーなしで受信されたマルチキャスト/機能パケットのバイト数。この数は、 OID_GEN_MULTICAST_BYTES_RCV が返す値と同じです。

ifHCInBroadcastOctets

エラーなしで受信されたブロードキャストパケットのバイト数。この数は、 OID_GEN_BROADCAST_BYTES_RCV が返す値と同じです。

ifHCOutUcastOctets

エラーなしで送信される送信パケットのバイト数。この数は、 OID_GEN_DIRECTED_BYTES_XMIT が返す値と同じです。

ifHCOutMulticastOctets

エラーなしで送信されるマルチキャスト/機能パケットのバイト数。この数は、 OID_GEN_MULTICAST_BYTES_XMIT が返す値と同じです。

ifHCOutBroadcastOctets

エラーなしで送信されるブロードキャストパケットのバイト数。この数は、 OID_GEN_BROADCAST_BYTES_XMIT が返す値と同じです。

CompartmentId

インターフェイスプロバイダーがインターフェイスが属するコンパートメントの ID を指定できる場合は、インターフェイスが属するコンパートメント。それ以外の場合は、NET_IF_COMPARTMENT_ID_UNSPECIFIEDを返す必要があります。インターフェイスプロバイダーがコンパートメント ID のNET_IF_COMPARTMENT_ID_UNSPECIFIEDを返す場合、NDIS はこのインターフェイスの適切なコンパートメント ID を返します。

SupportedStatistics

サポートされている統計。詳細については、NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES構造体の SupportedStatistics メンバーを参照してください。

注釈

NDIS インターフェイスプロバイダーは、OID_GEN_INTERFACE_INFO OID のクエリに応答して、NDIS_INTERFACE_INFORMATION 構造体を設定します。この構造体には、インターフェイスの有効期間中に変更される情報が含まれています。

インターフェイスプロバイダーとして登録するために、NDIS ドライバーは NdisIfRegisterProvider 関数を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 ドライバーでサポートされています。
Header	ifdef.h (Ndis.h を含む)