次の方法で共有


DPN_CAPS_EX 構造体

DPN_CAPS_EX 構造体

Microsoft® DirectPlay® のプロトコルをチューニングするパラメータの設定と取得に使う。

構文

typedef struct _DPN_CAPS_EX {
    DWORD dwSize;
    DWORD dwFlags;
    DWORD dwConnectTimeout;
    DWORD dwConnectRetries;
    DWORD dwTimeoutUntilKeepAlive;
    DWORD dwMaxRecvMsgSize;
    DWORD dwNumSendRetries;
    DWORD dwMaxSendRetryInterval;
    DWORD dwDropThresholdRate;
    DWORD dwThrottleRate;
    DWORD dwNumHardDisconnectSends;
    DWORD dwMaxHardDisconnectPeriod;
} DPN_CAPS_EX, *PDPN_CAPS_EX;

メンバ

  • dwSize
    この値は、構造体のサイズに設定する必要がある。
  • dwFlags
    予約済みであるので、0 に設定する。
  • dwConnectTimeout
    DirectPlay が接続要求を再送信するまで待機する時間 (ミリ秒単位)。
  • dwConnectRetries
    DirectPlay が接続処理中に行う接続の再試行の回数。
  • dwTimeoutUntilKeepAlive
    DirectPlay が、最後にエンドポイントからパケットを受け取ってからキープ アライブ メッセージを送信するまでに待機する時間 (ミリ秒単位)。実際の遅延は、指定した値から指定した値の 2 倍の範囲で変化する。
  • dwMaxRecvMsgSize
    受信するメッセージの最大サイズ (バイト単位)。
  • dwNumSendRetries
    接続が無効であると判断されるまでに、アプリケーションがメッセージの送信を再試行できる回数の最大値。
  • dwMaxSendRetryInterval
    メッセージの再送信を試みる最大の間隔 (ミリ秒単位)。
  • dwDropThresholdRate
    メッセージのスロットリングが適用されるまでに許可する、ドロップされるパケットのパーセンテージ。
  • dwThrottleRate
    メッセージ スロットリングを適用するときに送信キューを減らす割合。
  • dwNumHardDisconnectSends
    DPNCLOSE_IMMEDIATE フラグが指定されたときに送信するハード接続解除フレームの数。
  • dwMaxHardDisconnectPeriod
    送信するハード接続終了フレーム間の最大時間 (ミリ秒単位)。

注意

IDirectPlay8Peer オブジェクトまたは IDirectPlay8Client オブジェクトを保持する DPN_CAPS_EX 構造体を使うとき、dwMaxRecvMsgSize メンバは無視される。IDirectPlay8Peer および IDirectPlay8Client のコールバック関数は、dwMaxRecvMsgSize より大きいメッセージを含め、あらゆるサイズのメッセージを受け取る。

構造体の情報

ヘッダー dplay8.h
最低限のオペレーティング システム Windows 98、Pocket PC 2002