共用方式為

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 ，所以應用程式必須先呼叫 CoInitializeEx 方法，才能呼叫 XAudio2CreateVolumeMeter。 XAudio2Create的需求相同，這表示在呼叫XAudio2CreateVolumeMeter之前，通常會呼叫 CoInitializeEx。

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 是 xaudio2fx.h 中呼叫 CreateAudioVolumeMeter： ''' 語法的內嵌函式

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>