Metodo IXAudio2Voice::D isableEffect (xaudio2.h)

Articolo
08/28/2023

Disabilita l'effetto in una determinata posizione nella catena di effetti della voce.

Sintassi

\\HRESULT DisableEffect(
  [in] UINT32 EffectIndex,
  [in] UINT32 OperationSet
);

Parametri

[in] EffectIndex

Indice in base zero di un effetto nella catena di effetti della voce.

[in] OperationSet

Identifica questa chiamata come parte di un batch posticipato. Per altre informazioni, vedere la panoramica dei set di operazioni XAudio2 .

Valore restituito

Restituisce S_OK se ha esito positivo; in caso contrario, un codice di errore. Per le descrizioni dei codici di errore validi, vedere Codici di errore XAudio2 .

Commenti

Gli effetti in una determinata catena di effetti della voce XAudio2 devono usare e produrre audio a tale velocità di elaborazione della voce. L'unico aspetto del formato audio che possono cambiare è il conteggio dei canali. Ad esempio, un effetto riverbero può convertire i dati mono in 5.1. Il client può usare il campo OutputChannels della struttura di XAUDIO2_EFFECT_DESCRIPTOR per specificare il numero di canali che vuole produrre ogni effetto. Ogni effetto in una catena di effetti deve produrre un numero di canali che l'effetto successivo può utilizzare. Tutte le chiamate a IXAudio2Voice::EnableEffect o IXAudio2Voice::D isableEffect che renderanno la catena di effetti che non soddisfa questi requisiti avrà esito negativo.

La disabilitazione di un effetto lo rimuove immediatamente dal grafico di elaborazione. Qualsiasi audio in sospeso, ad esempio una coda di riverbero, non viene riprodotto. Prestare attenzione a disabilitare un effetto mentre la voce che ospita è in esecuzione. Ciò può comportare un artefatto udibile se l'effetto modifica significativamente il passo o il volume dell'audio.

DisableEffect ha effetto immediatamente quando viene chiamato da un callback XAudio2 con un OperationSet di XAUDIO2_COMMIT_NOW.

Requisiti della piattaforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	xaudio2.h

Vedi anche

IXAudio2Voice

Panoramica di XAPO

Condividi tramite