Microsoft DirectX 8.0 (C++)

IDirectPlayVoiceServer::StartSession

実行中の DirectPlay トランスポート セッション内で、初期化済みの Microsoft® DirectPlay® Voice セッションを開始する。このメソッドの呼び出しが成功しないと、クライアントは音声セッションへの接続を完了できない。

HRESULT StartSession(
PDVSESSIONDESC pSessionDesc,
DWORD dwFlags
);

パラメータ

pSessionDesc
セッションの記述を保持する DVSESSIONDESC 構造体へのポインタ。
dwFlags
予約済み。0 に設定しておく。

戻り値

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

DVERR_ALREADYPENDING
DVERR_HOSTING
DVERR_INVALIDFLAGS
DVERR_INVALIDOBJECT
DVERR_INVALIDPARAM
DVERR_INVALIDPOINTER
DVERR_NOTINITIALIZED

注意

このメソッドを呼び出す前に IDirectPlayVoiceServer::Initialize メソッドを呼び出す必要がある。音声セッションがピアツーピアである場合、音声セッションはセッションの任意のクライアントにホストできる。音声セッションがピアツーピアではない場合、アクティブなトランスポート セッションのホストであるトランスポート クライアントでホストする必要がある。

DVSESSIONDESC 構造体は開始する音声セッションのタイプを保持する。音声セッションのタイプによっては、クライアントとサーバーの CPU と帯域幅の使用について、大きな影響を与えることがある。DVSESSIONDESCguidCT メンバを DPVCTGUID_DEFAULT に設定できる。

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dvoice.h で宣言。