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

음성 효과 체인에서 지정된 효과의 현재 효과별 매개 변수를 반환합니다.

구문

\\HRESULT GetEffectParameters(
  [in]  UINT32 EffectIndex,
  [out] void   *pParameters,
  [out] UINT32 ParametersByteSize
);

매개 변수

[in] EffectIndex

음성 효과 체인 내 효과의 인덱스(0부터 시작)입니다.

[out] pParameters

효과별 매개 변수의 현재 값을 반환합니다.

[out] ParametersByteSize

pParameters 배열의 크기(바이트)입니다.

반환 값

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

효과가 제네릭 매개 변수 제어 인터페이스를 지원하지 않는 경우 E_NOTIMPL 함께 실패합니다.

설명

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

플랫폼 요구 사항

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

요구 사항

대상 플랫폼	Windows
헤더	xaudio2.h

참고 항목

IXAPOParameters::GetParameters

IXAudio2Voice

XAPO 개요