Metodo IXAudio2Voice::GetChannelVolumes (xaudio2.h)

Articolo
03/04/2024

Restituisce i livelli di volume per la voce, per canale.

Sintassi

\\ void GetChannelVolumes(
  [in]  UINT32 Channels,
  [out] float  *pVolumes
);

Parametri

[in] Channels

Conferma il conteggio dei canali della voce.

[out] pVolumes

Restituisce il livello di volume corrente di ogni canale nella voce. La matrice deve avere almeno gli elementi Channel . Per altre informazioni sui livelli di volume, vedere Osservazioni.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Queste impostazioni vengono applicate dopo l'applicazione della catena di effetti. Questo metodo è valido solo per le voci di origine e submix, perché le voci di mastering non specificano il volume per canale.

I livelli di volume vengono espressi come moltiplicatori a virgola mobile tra -2²⁴ a 2²⁴, con un guadagno massimo di 144,5 dB. Un volume di 1 significa che non esiste alcuna attenuazione o guadagno, 0 significa silenzio e i livelli negativi possono essere usati per invertire la fase dell'audio. Per altre informazioni sul controllo del volume, vedere Controllo volume e passo XAudio2 .

NotaGetChannelVolumes restituisce sempre i livelli di volume impostati più di recente da IXAudio2Voice::SetChannelVolumes. Tuttavia, questi valori potrebbero non essere effettivamente effettivi: essi hanno effetto solo la prossima volta che il motore audio viene eseguito dopo la chiamata IXAudio2Voice::SetChannelVolumes (o dopo la chiamata IXAudio2::CommitChanges , se IXAudio2Voice::SetChannelVolumes è stato chiamato con un ID operazione posticipato).

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

Condividi tramite