Microsoft DirectX 8.0 (C++)

IDirectPlayVoiceServer::GetTransmitTargets

セッション内のプレーヤーに対する音声ストリームの送信ターゲットを取得する (存在する場合)。

HRESULT GetTransmitTargets(
DVID dvSource,
PDVID pdvIDTargets,
PDWORD pdwNumTargets,
DWORD dwFlags
);

パラメータ

dvSource
ターゲットに送信するユーザーまたはグループの DVID。
pdvIDTargets
IDirectPlayVoiceServer::SetTransmitTargets メソッドにより設定されたプレーヤーまたはグループの現在のターゲットを指定する DVID の配列。このパラメータに NULL を指定して、ターゲットの数を取得することができる。
pdwNumTargets
配列内の DVID の数。このメソッドを呼び出す場合、この値は IDirectPlayVoiceServer::SetTransmitTargets メソッドで設定されたターゲット数と一致する必要がある。呼び出しが成功すると、Microsoft® DirectPlay® は pdvIDTargets 配列内の要素の数を返す。

pdvIDTargets が NULL である場合、0 に設定しておく。

dwFlags
予約済み。0 に設定しておく。

戻り値

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

DVERR_BUFFERTOOSMALL
DVERR_INVALIDFLAGS
DVERR_INVALIDPARAM
DVERR_INVALIDPOINTER
DVERR_NOTALLOWED
DVERR_NOTCONNECTED
DVERR_NOTINITIALIZED

注意

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

動作環境

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