DirectPlay DirectPlay C/C++ 레퍼런스 인터페이스 IDirectPlayVoiceClient GetTransmitTargets [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
이 클라이언트로부터의 음성 스트림의 송신 타겟을 얻어온다 (존재하는 경우).
구문
HRESULT GetTransmitTargets(
PDVID pdvIDTargets, PDWORD pdwNumTargets, DWORD dwFlags );
파라미터
- pdvIDTargets
- [out] IDirectPlayVoiceClient::SetTransmitTargets 메서드 또는 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 메서드를 호출할 필요가 있다.
주의
pdvIDTargets 파라미터에 돌려받는 값은, player DVID 나 그룹 DVID, 또는 정수 DVID_ALLPLAYERS 이다.
pdvIDTargets 로 지정된 버퍼가 작고, 타겟의 리스트가 저장 할 수 없는 경우, 이 메서드는 DVERR_BUFFERTOOSMALL 를 돌려주어, 필요한 요소수가 pdwNumTargets 로 설정된다.
타겟이 지정되지 않은 경우,pdwNumTargets 는 0 으로 설정되어 반환값은 DV_OK 가 된다.