IDirectPlayVoiceServer::StartSession メソッド
IDirectPlayVoiceServer::StartSession メソッド
実行中の DirectPlay トランスポート セッション内で、初期化済みの Microsoft® DirectPlay® Voice セッションを開始する。このメソッドの呼び出しが成功しないと、クライアントはボイス セッションへの接続を完了できない。
構文
HRESULT StartSession(
PDVSESSIONDESC pSessionDesc,
DWORD dwFlags
);
パラメータ
- pSessionDesc
[in] セッションの記述を保持する DVSESSIONDESC 構造体へのポインタ。 - dwFlags
[in] 予約済み。0 でなければならない。
戻り値
成功した場合は DV_OK を返す。または、次のいずれかのエラー値を返す。
| DVERR_ALREADYPENDING | このタイプの非同期呼び出しは既にペンディング状態になっている。 |
| DVERR_HOSTING | オブジェクトはセッションのホストである。 |
| DVERR_INVALIDFLAGS | このメソッドに渡されたフラグは無効である。 |
| DVERR_INVALIDOBJECT | DirectPlay オブジェクトのポインタは無効である。 |
| DVERR_INVALIDPARAM | メソッドに渡された 1 つ以上のパラメータが無効である。 |
| DVERR_INVALIDPOINTER | 指定されたポインタが無効である。 |
| DVERR_NOTINITIALIZED | このメソッドを呼び出す前に、IDirectPlayVoiceClient::Initialize メソッドまたは IDirectPlayVoiceServer::Initialize メソッドを呼び出す必要がある。 |
| DVERR_COMPRESSIONNOTSUPPORTED | 指定された圧縮タイプがローカル コンピュータでサポートされていない。 |
注意
このメソッドを呼び出す前に IDirectPlayVoiceServer::Initialize メソッドを呼び出す必要がある。ボイス セッションがピアツーピアである場合、ボイス セッションはセッションの任意のクライアントでホストできる。ボイス セッションがピアツーピアではない場合、アクティブなトランスポート セッションのホストであるトランスポート クライアントでホストする必要がある。
DVSESSIONDESC 構造体は、開始するボイス セッションのタイプを保持する。ボイス セッションのタイプによっては、クライアントとサーバーの CPU と帯域幅の使用について、大きな影響を与えることがある。デフォルトの圧縮タイプを使うには、DVSESSIONDESC 構造体の guidCT メンバを DPVCTGUID_DEFAULT に設定する。