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

아티클
08/28/2023

이 음성의 송신 중 하나에서 필터 매개 변수를 설정합니다.

구문

\\HRESULT SetOutputFilterParameters(
  [in] IXAudio2Voice                   *pDestinationVoice,
  [in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
  [in] UINT32                          OperationSet
);

매개 변수

[in] pDestinationVoice

IXAudio2Voice 필터 매개 변수가 설정될 송신의 대상 음성에 대한 포인터입니다.

[in] pParameters

필터 정보를 포함하는 XAUDIO2_FILTER_PARAMETERS 구조체에 대한 포인터입니다.

[in] OperationSet

이 호출을 지연된 일괄 처리의 일부로 식별합니다. 자세한 내용은 XAudio2 작업 집합 개요를 참조하세요.

반환 값

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

설명

XAUDIO2_SEND_USEFILTER 플래그를 사용하여 보내기를 만들지 않은 경우 SetOutputFilterParameters가 실패합니다. 이 메서드는 원본 및 서브믹스 음성에 속하는 송신에만 사용할 수 있으며 마스터링 음성의 송신에는 영향을 주지 않습니다.

참고IXAudio2Voice::GetOutputFilterParameters는 항상 이 송신의 실제 현재 필터 매개 변수를 반환합니다. 그러나 이러한 매개 변수는 가장 최근 IXAudio2Voice::SetOutputFilterParameters 호출에서 설정한 매개 변수와 일치하지 않을 수 있습니다. 실제 매개 변수는 다음에 오디오 엔진이 IXAudio2Voice::SetOutputFilterParameters 호출(또는 해당 IXAudio2::CommitChanges 호출 후 실행된 후에만 변경됩니다.) IXAudio2Voice::SetOutputFilterParameters 가 지연된 작업 ID로 호출되었으면 입니다.

플랫폼 요구 사항

Windows 10(XAudio2.9); Windows 8, Windows Phone 8(XAudio 2.8); DirectX SDK(XAudio 2.7)

요구 사항


대상 플랫폼	Windows
헤더	xaudio2.h

참고 항목

IXAudio2Voice