IDirectPlay8Server::Initialize メソッド

  • [アーティクル]

IDirectPlay8Server::Initialize メソッド

IDirectPlay8Server インターフェイスおよびリモート クライアントからメッセージを受信する、サーバーのコード内のエントリ ポイントを登録する。このメソッドを呼び出してから、このインターフェイスのその他のメソッドを呼び出す必要がある。

構文

HRESULT Initialize(      
    PVOID const pvUserContext,
    const PFNDPNMESSAGEHANDLER pfn,
    const DWORD dwFlags
);

パラメータ

  • pvUserContext
    [in] メッセージ ハンドラの呼び出しで指定されるユーザー指定のコンテキスト値。ユーザー指定のコンテキスト値は、複数のインターフェイスから共通のメッセージ ハンドラに送信されたメッセージを区別するのに役立つ。
  • pfn
    [in] PFNDPNMESSAGEHANDLER コールバック関数へのポインタ。この関数は、リモート クライアントからのすべてのメッセージを受信し、IDirectPlay8Server インターフェイスからのセッションの変更通知を受信する。
  • dwFlags
    [in] 次のフラグを指定できる。
    • DPNINITIALIZE_DISABLEPARAMVAL
      このフラグを渡すと、現在のオブジェクトに対するパラメータ妥当性の検証が無効になる。
    • DPNINITIALIZE_HINT_LANSESSION
      ローカル エリア ネットワーク (LAN) で実行されているゲーム用にさらに大きい送信ウィンドウを開く。
    • DPNINITIALIZE_DISABLELINKTUNING
      調査対象のネットワーク条件に対する送信速度を MicrosoftR DirectPlay® が調整できないようにする。最初に可能になったときに、メッセージがネットワークにプッシュされる。

戻り値

成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。

DPNERR_INVALIDFLAGS このメソッドに渡されたフラグは無効である。
DPNERR_INVALIDPARAM メソッドに渡された 1 つ以上の引数が無効である。

注意

IDirectPlay8Server インターフェイスを取得するには、CoCreateInstance を使った後にこのメソッドを呼び出す。

ネットワーク条件によって送信速度を変えるのではなく、固定の速度で送信する場合、アプリケーションは DPNINITIALIZE_DISABLELINKTUNING フラグを指定できる。このフラグを指定すると、DirectPlay は、常に、すべてのアプリケーション データを転送するための容量がネットワークにあると見なし、ネットワーク帯域幅に応じた送信速度の調整を行わない。このフラグを指定して、ネットワーク容量を超える速度で送信すると、遅延やパケット ドロップ レートの増大などの予期しないネットワーク動作が発生する。送信キューを監視し、利用可能な帯域幅を有効利用できるように動的に送信速度を調整するアプリケーションでは、このフラグを指定してはならない。

DPNINITIALIZE_DISABLELINKTUNING フラグが指定されている場合、メッセージは常に、キューに入れられることなくネットワークに直接送信されるので、メッセージの優先順位付け、結合、タイムアウトなどの DirectPlay の機能は有効ではない。