Metodo IXAudio2Voice::GetOutputMatrix (xaudio2.h)

Articolo
03/13/2024

Ottiene il livello di volume di ogni canale dell'output finale per la voce. Questi canali vengono mappati ai canali di input di una voce di destinazione specificata.

Sintassi

\\ void GetOutputMatrix(
  [in]  IXAudio2Voice *pDestinationVoice,
  [in]  UINT32        SourceChannels,
  [in]  UINT32        DestinationChannels,
  [out] float         *pLevelMatrix
);

Parametri

[in] pDestinationVoice

Puntatore che specifica la destinazione IXAudio2Voice per recuperare la matrice di output per.

Nota Se la voce invia a una singola voce di destinazione, la specifica di NULL causerà l'funzionamento di GetOutputMatrix su tale voce di destinazione.

[in] SourceChannels

Conferma il numero di canali di output della voce. Si tratta del numero di canali prodotti dall'ultimo effetto nella catena.

[in] DestinationChannels

Conferma il conteggio del canale di input della voce di destinazione.

[out] pLevelMatrix

Matrice di livelli di volume [SourceChannels DestinationChannels * ] inviati alla voce di destinazione. Il livello inviato dal canale di origine S al canale di destinazione D viene restituito nel formato pLevelMatrix[DestinationChannels × S + D]. Per altre informazioni sui livelli di volume, vedere Osservazioni.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Questo metodo si applica solo alle voci di origine e submix, perché le voci mastering scrivono direttamente nel dispositivo senza mix di matrice.

I livelli di volume vengono espressi come moltiplicatori a virgola mobile tra -2²⁴ a 2²⁴, con un guadagno massimo di 144,5 dB. Un livello di volume pari a 1 significa che non esiste 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 .

Per informazioni sull'ordinamento standard del canale, vedere WAVEFORMATEXTENSIBLE .

NotaGetOutputMatrix restituisce sempre i livelli impostati di recente da IXAudio2Voice::SetOutputMatrix. Tuttavia, potrebbero non essere effettivamente effettive: hanno effetto solo la prossima volta che il motore audio viene eseguito dopo la chiamata IXAudio2Voice::SetOutputMatrix (o dopo la chiamata IXAudio2::CommitChanges , se IXAudio2Voice::SetOutputMatrix è 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