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 |