IDirectPlayVoiceServer::GetTransmitTargets 메서드

세션내의 player에 대한 음성 스트림의 송신 타겟을 얻어온다 (존재하는 경우).

구문

HRESULT GetTransmitTargets(      

    DVID dvSource,
    PDVID pdvIDTargets,
    PDWORD pdwNumTargets,
    DWORD dwFlags
);

파라미터

dvSource

[in] 타겟으로 송신하는 사용자 또는 그룹의 DVID.

pdvIDTargets

[out] IDirectPlayVoiceServer::SetTransmitTargets 메서드에 의해 설정된 player 또는 그룹의 현재의 타겟을 보관 유지하는 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 를 돌려준다.