Funzione XAudio2CreateVolumeMeter (xaudio2fx.h)

Articolo
08/28/2023

Crea un nuovo oggetto di elaborazione audio del contatore del volume (APO) e restituisce un puntatore.

Sintassi

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

Parametri

[in, out] ppApo

Contiene l'APO del contatore del volume creato.

[in] DEFAULT

Flag che specificano il comportamento dell'apo. Il valore di questo parametro deve essere 0.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per informazioni sulla creazione di nuovi effetti da usare con XAudio2, vedere panoramica di XAPO.

Windows

Windows
Poiché XAudio2CreateVolumeMeter chiama CoCreateInstance in Windows, l'applicazione deve aver chiamato il metodo CoInitializeEx prima di chiamare XAudio2CreateVolumeMeter. XAudio2Create ha lo stesso requisito, il che significa che CoInitializeEx in genere verrà chiamato molto tempo prima che venga chiamato XAudio2CreateVolumeMeter . Un modello di chiamata tipico in Windows è il seguente: `#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);`

Poiché XAudio2CreateVolumeMeter chiama CoCreateInstance in Windows, l'applicazione deve aver chiamato il metodo CoInitializeEx prima di chiamare XAudio2CreateVolumeMeter. XAudio2Create ha lo stesso requisito, il che significa che CoInitializeEx in genere verrà chiamato molto tempo prima che venga chiamato XAudio2CreateVolumeMeter .

Un modello di chiamata tipico in Windows è il seguente:

#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'intestazione xaudio2fx.h definisce il GUID della classe AudioVolumeMeter come oggetto di elaborazione audio multipiattaforma (XAPO).

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

XAudio2CreateVolumeMeter restituisce questo oggetto come puntatore a un puntatore a IUnknown nel parametro ppApo . Sebbene sia possibile eseguire query sulle interfacce IXAPO e IXAPOParameters da questo IUnknown, in genere non si usano mai direttamente queste interfacce. Vengono invece usati quando si crea una voce per aggiungerli come parte della catena di effetti.

Il contatore del volume usa la struttura dei parametri XAUDIO2FX_VOLUMEMETER_LEVELS a cui si accede tramite il metodo IXAudio2Voice::GetEffectParameters quando L'XAPO è associato al grafico audio.

NotaXAudio2CreateVolumeMeter è una funzione inline in xaudio2fx.h che chiama la sintassi 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>

Condividi tramite