NETCONNECTINFOSTRUCT 構造体 (winnetwk.h)

  • [アーティクル]

NETCONNECTINFOSTRUCT 構造体には、ネットワークのパフォーマンスに関する情報が含まれています。 NPGetConnectionPerformance 関数によって使用されます。

構文

typedef struct _NETCONNECTINFOSTRUCT {
  DWORD cbStructure;
  DWORD dwFlags;
  DWORD dwSpeed;
  DWORD dwDelay;
  DWORD dwOptDataSize;
} NETCONNECTINFOSTRUCT, *LPNETCONNECTINFOSTRUCT;

メンバー

cbStructure

NETCONNECTINFOSTRUCT 構造体のサイズ (バイト単位)。 これは、渡された構造体のサイズを示すために、呼び出し元によって入力されます。 ネットワーク プロバイダーは、このフィールドを変更せずに、 構造体が dwOptDataSize までのすべてのフィールドを含めるのに十分な大きさであると想定できます。

dwFlags

これは、次のフラグの 1 つ以上を持つビットマスクです。

値 説明
WNCON_FORNETCARD
 設定されている場合、返される情報は、接続に使用されるネットカードのパフォーマンスを表します。 この情報は、実際の接続に関する情報が利用できない場合に返されます。

設定されていない場合、返される情報はリソースとの現在の接続に関する情報であり、ルーティングの低下が考慮されます。
WNCON_NOTROUTED
 設定した場合、接続はルーティング対象として扱われません。 つまり、パフォーマンスを見積もるときにルーティングは考慮されません。 つまり、実際のパフォーマンスは、返される情報よりもはるかに少なくなる可能性があります。

設定されていない場合、接続はパフォーマンスを制限するルーターを経由している可能性があります。
WNCON_SLOWLINK
 設定されている場合、接続は、通常は低速なメディア (通常の品質の電話回線を使用するモデムなど) を経由していることがわかっている場合があります。

dwSpeed で値を返すプロバイダーは、このビットを設定する必要はありません。
WNCON_DYNAMIC
 設定すると、返される情報の一部が動的に再計算されます。 その場合、接続でこの要求を再発行すると、異なる、より最新の情報が返される可能性があります。

dwSpeed

ネットワーク リソースに対するメディアの速度を 100bps 単位で指定します。 たとえば、1,200 ボーのポイントツーポイント リンクは 12 を返します。

dwDelay

情報を送信するときにネットワークによって発生する遅延 (ミリ秒単位)。 つまり、ネットワークがデータの送信を開始してから受信までの時間です。 これは、 dwSpeed の計算に組み込まれた待機時間に加えて、ほとんどのリソースにアクセスするために返される値は 0 になります。

dwOptDataSize

アプリケーションがネットワーク リソースに対して 1 つの要求を行うときに最も効率的にネットワーク経由で送信されるデータのサイズ (バイト単位) に関する推奨事項。 たとえば、ディスク ネットワーク リソースの場合、データ ブロックを書き込む場合、この値は 2048 または 512 になります。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header winnetwk.h