Metodo IXAudio2Voice::EnableEffect (xaudio2.h)

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

Sintassi

\\HRESULT EnableEffect(
  [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 panoramica dei set di operazioni XAudio2 .

Valore restituito

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

Commenti

Prestare attenzione quando si abilita un effetto mentre la voce che lo ospita è in esecuzione. Un'azione di questo tipo può causare un problema se l'effetto modifica significativamente l'inclinazione o il volume dell'audio.

Gli effetti in una determinata catena di effetti della voce XAudio2 devono utilizzare e produrre audio con la frequenza di campionamento di elaborazione di tale 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 XAUDIO2_EFFECT_DESCRIPTOR per specificare il numero di canali che desidera produrre ogni effetto. Ogni effetto in una catena di effetti deve produrre un numero di canali che l'effetto successivo può utilizzare. Qualsiasi chiamata a IXAudio2Voice::EnableEffect o IXAudio2Voice::D isableEffect che renderebbe la catena di effetti che smetterà di soddisfare questi requisiti avrà esito negativo.

EnableEffect diventa effettivo immediatamente quando lo chiami 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

Piattaforma di destinazione	Windows
Intestazione	xaudio2.h

Vedi anche

IXAudio2Voice

Panoramica di XAPO