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

음성의 필터 매개 변수를 설정합니다.

구문

\\HRESULT SetFilterParameters(
  [in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
  [in] UINT32                          OperationSet
);

매개 변수

[in] pParameters

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

[in] OperationSet

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

반환 값

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

설명

XAUDIO2_VOICE_USEFILTER 플래그를 사용하여 음성을 만들지 않은 경우 SetFilterParameters가 실패합니다.

이 메서드는 원본 및 서브믹스 음성에서만 사용할 수 있으며 음성 마스터에 영향을 주지 않습니다.

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

 

플랫폼 요구 사항

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

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	xaudio2.h

추가 정보

IXAudio2Voice