Compartir a través de

Función XAudio2CreateVolumeMeter (xaudio2fx.h)

  • Artículo

Crea un nuevo objeto de procesamiento de audio de medidor de volumen (APO) y devuelve un puntero a él.

Sintaxis

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

Parámetros

[in, out] ppApo

Contiene el APO de medidor de volumen creado.

[in] DEFAULT

Marcas que especifican el comportamiento del APO. El valor de este parámetro debe ser 0.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Observaciones

Para obtener información sobre cómo crear nuevos efectos para su uso con XAudio2, consulte la información general de XAPO.

Windows
Dado que XAudio2CreateVolumeMeter llama a CoCreateInstance en Windows, la aplicación debe haber llamado al método CoInitializeEx antes de llamar a XAudio2CreateVolumeMeter. XAudio2Create tiene el mismo requisito, lo que significa que se suele llamar a CoInitializeEx mucho antes de llamar a XAudio2CreateVolumeMeter .

Un patrón de llamada típico en Windows sería el siguiente:

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

El encabezado xaudio2fx.h define el GUID de la clase AudioVolumeMeter como un objeto de procesamiento de audio multiplataforma (XAPO).

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

XAudio2CreateVolumeMeter devuelve este objeto como puntero a un puntero a IUnknown en el parámetro ppApo . Aunque puede consultar las interfaces IXAPO e IXAPOParameters desde este IUnknown, normalmente nunca se usan directamente estas interfaces. En su lugar, los usa al crear una voz para agregarlos como parte de la cadena de efectos.

El medidor de volumen usa la estructura de parámetros XAUDIO2FX_VOLUMEMETER_LEVELS a la que se accede a través del método IXAudio2Voice::GetEffectParameters cuando el XAPO está enlazado al gráfico de audio.

NotaXAudio2CreateVolumeMeter es una función insertada en xaudio2fx.h que llama a CreateAudioVolumeMeter: sintaxis '''

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>