Metodo IXAudio2Voice::SetVolume (xaudio2.h)

Articolo
03/13/2024

Imposta il livello di volume complessivo per la voce.

Sintassi

\\HRESULT SetVolume(
  [in] float  Volume,
  [in] UINT32 OperationSet
);

Parametri

[in] Volume

Livello di volume complessivo da usare. Per altre informazioni sui livelli di volume, vedere La sezione Osservazioni.

[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

SetVolume controlla il livello del volume di input master di una voce. Il livello del volume master viene applicato in momenti diversi a seconda del tipo di voce. Per le voci di submix e mastering, il livello del volume viene applicato subito prima dell'applicazione del filtro e della catena di effetti incorporata della voce. Per le voci di origine il livello del volume master viene applicato dopo l'applicazione del filtro e della catena di effetti della voce.

I livelli di volume sono espressi come moltiplicatori di ampiezza a virgola mobile tra -XAUDIO2_MAX_VOLUME_LEVEL e XAUDIO2_MAX_VOLUME_LEVEL (-2²⁴ a 2²⁴), con un guadagno massimo di 144,5 dB. Un livello di volume di 1,0 indica che non c'è attenuazione o guadagno e 0 significa silenzio. I livelli negativi possono essere usati per invertire la fase dell'audio. Per altre informazioni sul controllo del volume, vedere Controllo volume e pitch di XAudio2 .

NotaIXAudio2Voice::GetVolume restituisce sempre il volume impostato più di recente da IXAudio2Voice::SetVolume. Tuttavia, potrebbe non essere ancora attivo: ha effetto solo la volta successiva che il motore audio viene eseguito dopo la chiamata IXAudio2Voice::SetVolume (o dopo la chiamata IXAudio2::CommitChanges corrispondente, se IXAudio2Voice::SetVolume è stato chiamato con un ID operazione posticipata).

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

Procedura: Modificare il volume vocale

Procedura: Usare voci di missaggio secondario

IXAudio2Voice

Share via