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>