Microsoft DirectX 8.0 (C++)

IDirectPlayVoiceServer::SetTransmitTargets

クライアントからセッションの指定されたメンバへのオーディオの送信を制御する。

HRESULT SetTransmitTargets(
DVID dvSource,
PDVID pdvIDTargets,
DWORD dwNumTargets,
DWORD dwFlags
);

パラメータ

dvSource
ターゲットが設定されるユーザーの DVID。
pdvIDTargets
オーディオ送信のターゲットであるプレーヤー DVID またはグループ DVID のリスト。いずれのターゲットも指定しない場合は、このパラメータに NULL を渡す。さらに、このパラメータには次の値も設定することができる。
DVID_ALLPLAYERS
このクライアントはセッションのすべてのプレーヤーをターゲットとする。配列内の唯一の要素である必要がある。
dwNumTargets
配列内の DVID の数。この値は 64 を超えてはならない。pdvIDTargets が NULL の場合、この値は 0 に設定する。
dwFlags
予約済み。0 に設定しておく。

戻り値

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

DVERR_INVALIDFLAGS
DVERR_INVALIDPARAM
DVERR_INVALIDPOINTER
DVERR_INVALIDTARGET
DVERR_NOTALLOWED
DVERR_NOTINITIALIZED

注意

Microsoft® DirectX® 8.0 の場合、転送できる個々のターゲットの数は、64 までに制限される。この値を超えると、メソッドは失敗し、DVERR_NOTALLOWED を返す。ただし、65 人以上のプレーヤーに転送することもできる。そのためには、プレーヤーをグループにまとめ、グループをターゲットとして使用する。

このパラメータには重複ターゲットを指定してはならない。また、エントリはすべて有効な DVID である必要がある。ターゲットが個々の DVID を持つプレーヤーおよびターゲットが所属するグループ内のプレーヤーを含む場合、Microsoft® DirectPlay® Voice はプレーヤーに重複音声パケットが送信されないようにする。

このメソッドは、DirectPlay Voice セッションの作成時に DVSESSION_SERVERCONTROLTARGET フラグが指定された場合にのみ使用できる。このフラグが指定されていない場合、メソッドは DVERR_NOTALLOWED を返す。

動作環境

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