IXAudio2Voice::SetOutputVoices 메서드(xaudio2.h)

음성 출력을 받을 새 서브믹스 또는 마스터링 음성 집합을 지정합니다.

구문

\\HRESULT SetOutputVoices(
  [in] const XAUDIO2_VOICE_SENDS *pSendList
);

매개 변수

[in] pSendList

대상 음성에 대한 XAUDIO2_VOICE_SENDS 구조 포인터의 배열입니다. pSendList가 NULL인 경우 음성은 출력을 현재 마스터링 음성으로 보냅니다. 출력을 아무 곳에도 보내지 않도록 음성을 설정하려면 XAUDIO2_VOICE_SENDSOutputCount 멤버를 0으로 설정합니다. 보내기 목록의 모든 음성은 동일한 입력 샘플 속도를 가져야 합니다. 추가 정보는 XAudio2 샘플 속도 변환을 참조하세요 .

반환 값

성공하면 S_OK 반환하고, 그렇지 않으면 오류 코드를 반환합니다. XAudio2 특정 오류 코드에 대한 설명은 XAudio2 오류 코드를 참조하세요.

설명

이 메서드는 원본 및 서브믹스 음성에만 유효합니다. 음성 마스터는 오디오를 다른 음성으로 보낼 수 없습니다.

SetOutputVoices를 호출한 후 음성의 현재 송신 수준이 기본 송신 매트릭스로 대체됩니다. 새 송신 목록에 대한 사용자 지정 행렬을 설정하려면 IXAudio2Voice::SetOutputMatrix 메서드를 호출해야 합니다.

콜백 내에서 SetOutputVoices 를 호출하는 것은 잘못되었습니다(즉, IXAudio2EngineCallback 또는 IXAudio2VoiceCallback). SetOutputVoices가 콜백 내에서 호출되면 XAUDIO2_E_INVALID_CALL 반환합니다.

참고SetOutputVoices를 호출하면 이전에 IXAudio2Voice::SetOutputMatrix로 설정된 송신 매트릭스가 무효화됩니다.

 

플랫폼 요구 사항

Windows 8, Windows Phone 8(XAudio 2.8); DirectX SDK(XAudio 2.7)

요구 사항

대상 플랫폼	Windows
헤더	xaudio2.h

참고 항목

IXAudio2Voice