IDirectPlayVoiceServer::GetTransmitTargets メソッド

IDirectPlayVoiceServer::GetTransmitTargets メソッド

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

構文

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

パラメータ

• dvSource
  [in] ターゲットに送信するユーザーまたはグループの DVID。
• pdvIDTargets
  [out] IDirectPlayVoiceServer::SetTransmitTargets メソッドにより設定されたプレーヤまたはグループの現在のターゲットを保持する DVID の配列。このパラメータに NULL を指定して、ターゲットの数を取得できる。
• pdwNumTargets
  [in, out] pdvIDTargets 配列内の DVID の数。呼び出しが成功すると、メソッドが戻るとき、このパラメータは pdvIDTargets 配列の要素の数に設定される。配列が小さすぎると、メソッドは DVERR_BUFFERTOOSMALL を返し、pdwNumTargets は必要な要素の数に設定される。pdvIDTargets が NULL である場合、0 に設定しておく。
• dwFlags
  [in] 予約済み。0 でなければならない。

戻り値

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

DVERR_BUFFERTOOSMALL	指定されたバッファが小さすぎて、要求されたデータを格納できない。
DVERR_INVALIDFLAGS	このメソッドに渡されたフラグは無効である。
DVERR_INVALIDPARAM	メソッドに渡された 1 つ以上のパラメータが無効である。
DVERR_INVALIDPOINTER	指定されたポインタが無効である。
DVERR_NOTALLOWED	オブジェクトには、この処理を実行する権限がない。
DVERR_NOTCONNECTED	Microsoft® DirectPlay® Voice オブジェクトが接続されていない。
DVERR_NOTINITIALIZED	このメソッドを呼び出す前に、IDirectPlayVoiceClient::Initialize メソッドまたは IDirectPlayVoiceServer::Initialize メソッドを呼び出す必要がある。

注意

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