다음을 통해 공유

XAudio2CreateVolumeMeter 함수(xaudio2fx.h)

  • 아티클

새 볼륨 미터 APO(오디오 처리 개체)를 만들고 포인터를 반환합니다.

구문

HRESULT XAudio2CreateVolumeMeter(
  [in, out] IUnknown     **ppApo,
  [in]      UINT32 Flags DEFAULT
);

매개 변수

[in, out] ppApo

생성된 볼륨 미터 APO를 포함합니다.

[in] DEFAULT

APO의 동작을 지정하는 플래그입니다. 이 매개 변수의 값은 0이어야 합니다.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

XAudio2에서 사용할 새 효과를 만드는 방법에 대한 자세한 내용은 XAPO 개요를 참조하세요.

Windows
XAudio2CreateVolumeMeter는 Windows에서 CoCreateInstance를 호출하므로 XAudio2CreateVolumeMeter를 호출하기 전에 애플리케이션에서 CoInitializeEx 메서드를 호출해야 합니다. XAudio2Create 에는 동일한 요구 사항이 있습니다. 즉, CoInitializeEx 는 일반적으로 XAudio2CreateVolumeMeter 가 호출되기 훨씬 전에 호출됩니다.

Windows의 일반적인 호출 패턴은 다음과 같습니다.

#ifndef _XBOX
CoInitializeEx(NULL, COINIT_MULTITHREADED);
#endif
IXAudio2* pXAudio2 = NULL;
HRESULT hr;
if ( FAILED(hr = XAudio2Create( &pXAudio2, 0, XAUDIO2_DEFAULT_PROCESSOR ) ) )
    return hr;
...
IUnknown * pVolumeMeterAPO;
XAudio2CreateVolumeMeter(&pVolumeMeterAPO);
 

xaudio2fx.h 헤더는 AudioVolumeMeter 클래스 GUID를 XAPO(플랫폼 간 오디오 처리 개체)로 정의합니다.

class __declspec(uuid("4FC3B166-972A-40CF-BC37-7DB03DB2FBA3")) AudioVolumeMeter;

XAudio2CreateVolumeMeter는 이 개체를 ppApo 매개 변수의 IUnknown에 대한 포인터에 대한 포인터로 반환합니다. 이 IUnknown에서 IXAPO 및 IXAPOParameters 인터페이스를 쿼리할 수 있지만 일반적으로 이러한 인터페이스를 직접 사용하지는 않습니다. 대신, 효과 체인의 일부로 추가할 음성을 만들 때 사용합니다.

볼륨 미터는 XAPO가 오디오 그래프에 바인딩될 때 IXAudio2Voice::GetEffectParameters 메서드를 통해 액세스하는 XAUDIO2FX_VOLUMEMETER_LEVELS 매개 변수 구조를 사용합니다.

참고XAudio2CreateVolumeMeter 는 CreateAudioVolumeMeter: ''' 구문을 호출하는 xaudio2fx.h의 인라인 함수입니다.

XAUDIO2FX_STDAPI CreateAudioVolumeMeter(Outptr IUnknown** ppApo); __inline HRESULT XAudio2CreateVolumeMeter(Outptr IUnknown** ppApo, UINT32 /Flags/ DEFAULT(0)) { return CreateAudioVolumeMeter(ppApo); }


</div>
<div> </div>
<h3><a id="Platform_Requirements"></a><a id="platform_requirements"></a><a id="PLATFORM_REQUIREMENTS"></a>Platform Requirements</h3>
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

## Requirements
| Requirement | Value |
| ---- |:---- |
| **Target Platform** | Windows |
| **Header** | xaudio2fx.h |
| **Library** | Xaudio2.lib |

## See also

<a href="/windows/desktop/xaudio2/how-to--create-an-effect-chain">How to: Create an Effect Chain</a>



<a href="/windows/desktop/api/xaudio2/nf-xaudio2-ixaudio2voice-seteffectparameters">IXAudio2Voice::SetEffectParameters</a>



<a href="/windows/desktop/api/xaudio2fx/ns-xaudio2fx-xaudio2fx_volumemeter_levels">XAUDIO2FX_VOLUMEMETER_LEVELS</a>



<a href="/windows/desktop/xaudio2/functions">XAudio2 Functions</a>