Condividi tramite

Funzione XAudio2CreateReverb (xaudio2fx.h)

  • Articolo

Crea un nuovo oggetto di elaborazione audio riverbero (APO) e restituisce un puntatore.

Sintassi

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

Parametri

[in, out] ppApo

Contiene un puntatore all'APO riverbero creata.

[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

XAudio2CreateReverb crea un effetto che esegue Princeton Digital Reverb. La libreria di effetti XAPO (XAPOFX) include un effetto riverbero alternativo. Usare CreateFX per creare questo effetto alternativo.

L'APO riverbero supporta le restrizioni seguenti:

  • I dati audio di input devono essere FLOAT32.
  • La frequenza dei fotogrammi deve essere compresa tra XAUDIO2FX_REVERB_MIN_FRAMERATE (20.000 Hz) e XAUDIO2FX_REVERB_MAX_FRAMERATE (48.000 Hz).
  • I canali di input e output devono essere una delle combinazioni seguenti.
    • Input Mono e output mono
    • Input Mono e output 5.1
    • Input stereo e output stereo
    • Input stereo e output 5.1
L'APO riverbero mantiene informazioni sullo stato interne tra campioni di elaborazione. È possibile usare un'istanza di APO solo con una fonte di dati audio alla volta. Ogni voce che richiede effetti riverbero deve creare un effetto riverbero separato con XAudio2CreateReverb.

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

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

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 * pReverbAPO;
XAudio2CreateReverb(&pReverbAPO);
 

L'intestazione xaudio2fx.h definisce il GUID della classe AudioReverb come oggetto di elaborazione audio multipiattaforma (XAPO).

class __declspec(uuid("C2633B16-471B-4498-B8C5-4F0959E2EC09")) AudioReverb;

XAudio2CreateReverb 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 riverbero usa la struttura dei parametri XAUDIO2FX_REVERB_PARAMETERS a cui si accede tramite IXAudio2Voice::SetEffectParameters.

NotaXAudio2CreateReverb è una funzione inline in xaudio2fx.h che chiama la sintassi CreateAudioReverb: '''

XAUDIO2FX_STDAPI CreateAudioReverb(Outptr IUnknown** ppApo); __inline HRESULT XAudio2CreateReverb(Outptr IUnknown** ppApo, UINT32 /Flags/ DEFAULT(0)) { return CreateAudioReverb(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 |
| **DLL** | Windows.Media.Audio.dll |

## 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_reverb_parameters">XAUDIO2FX_REVERB_PARAMETERS</a>



<a href="/windows/desktop/xaudio2/functions">XAudio2 Functions</a>