Metodo IXAudio2Voice::SetChannelVolumes (xaudio2.h)

Articolo
03/13/2024

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

Sintassi

\\HRESULT SetChannelVolumes(
  [in] UINT32      Channels,
  [in] const float *pVolumes,
  [in] UINT32      OperationSet
);

Parametri

[in] Channels

Numero di canali nella voce.

[in] pVolumes

Matrice contenente i nuovi volumi di ogni canale nella voce. La matrice deve avere elementi Channel . Per altre informazioni sui livelli di volume, vedere Osservazioni.

[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 specifici di XAudio2, vedere Codici di errore XAudio2 .

Commenti

SetChannelVolumes controlla i livelli di output per canale di una voce e viene applicato subito dopo l'SRC finale della voce e prima dell'invio.

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 -XAUDIO2_MAX_VOLUME_LEVEL e XAUDIO2_MAX_VOLUME_LEVEL (-2²⁴ a 2²⁴), con un guadagno massimo pari a 144,5 dB. Un volume di 1 significa che non c'è alcuna 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 passo XAudio2 .

NotaIXAudio2Voice::GetChannelVolumes restituisce sempre i livelli di volume più recenti impostati 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

Procedura: Modificare il volume voce

IXAudio2Voice

Share via