Microsoft DirectX 8.0 (C++)

IDirectPlayVoiceClient::GetTransmitTargets

このクライアントからの音声ストリームの送信ターゲットを取得する (存在する場合)。

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

パラメータ

pdvIDTargets
IDirectPlayVoiceClient::SetTransmitTargets メソッドまたは IDirectPlayVoiceServer::SetTransmitTargets メソッドにより設定されたターゲットを指定する DVID の配列を格納するメンバ。このパラメータに NULL を指定して、ターゲットの数を取得することができる。
pdwNumTargets
配列内の DVID の数。このメソッドを呼び出す場合、この値は IDirectPlayVoiceClient::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

注意

pdvIDTargets パラメータに返される値は、プレーヤー DVID かグループ DVID、または定数 DVID_ALLPLAYERS である。

pdvIDTargets に指定されたバッファが小さく、ターゲットのリストが格納できない場合、このメソッドは DVERR_INVALIDPOINTER を返し、必要な要素数が pdwNumTargets に設定される。

ターゲットが指定されていない場合、pdwNumTargets は 0 に設定され、戻り値は DV_OK になる。

動作環境

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