Fonction XAudio2CreateVolumeMeter (xaudio2fx.h)

Article
08/28/2023

Crée un objet de traitement audio (APO) de compteur de volume et retourne un pointeur vers celui-ci.

Syntaxe

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

Paramètres

[in, out] ppApo

Contient l’APO du compteur de volume créé.

[in] DEFAULT

Indicateurs qui spécifient le comportement de l’APO. La valeur de ce paramètre doit être 0.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Pour plus d’informations sur la création d’effets à utiliser avec XAudio2, consultez vue d’ensemble de XAPO.

Windows

Windows
Étant donné que XAudio2CreateVolumeMeter appelle CoCreateInstance sur Windows, l’application doit avoir appelé la méthode CoInitializeEx avant d’appeler XAudio2CreateVolumeMeter. XAudio2Create a la même exigence, ce qui signifie que CoInitializeEx sera généralement appelé longtemps avant l’appel de XAudio2CreateVolumeMeter . Un modèle d’appel classique sur Windows se présente comme suit : `#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);`

Étant donné que XAudio2CreateVolumeMeter appelle CoCreateInstance sur Windows, l’application doit avoir appelé la méthode CoInitializeEx avant d’appeler XAudio2CreateVolumeMeter. XAudio2Create a la même exigence, ce qui signifie que CoInitializeEx sera généralement appelé longtemps avant l’appel de XAudio2CreateVolumeMeter .

Un modèle d’appel classique sur Windows se présente comme suit :

#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);

L’en-tête xaudio2fx.h définit le GUID de classe AudioVolumeMeter en tant qu’objet de traitement audio multiplateforme (XAPO).

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

XAudio2CreateVolumeMeter retourne cet objet en tant que pointeur vers un pointeur vers IUnknown dans le paramètre ppApo . Bien que vous puissiez interroger les interfaces IXAPO et IXAPOParameters à partir de cet IUnknown, vous n’utilisez généralement jamais ces interfaces directement. Au lieu de cela, vous les utilisez lorsque vous créez une voix pour les ajouter dans le cadre de la chaîne d’effets.

Le compteur de volume utilise la structure de paramètres XAUDIO2FX_VOLUMEMETER_LEVELS à laquelle vous accédez via la méthode IXAudio2Voice::GetEffectParameters lorsque le XAPO est lié au graphe audio.

RemarqueXAudio2CreateVolumeMeter est une fonction inline dans xaudio2fx.h qui appelle la syntaxe 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>

Share via