IXAudio2Voice::GetOutputMatrix-Methode (xaudio2.h)

Artikel
08/28/2023

Ruft die Lautstärke der einzelnen Kanäle der endgültigen Ausgabe für die Stimme ab. Diese Kanäle werden den Eingabekanälen einer angegebenen Zielstimme zugeordnet.

Syntax

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

Parameter

[in] pDestinationVoice

Zeiger, der das IxAudio2Voice-Ziel angibt, für das die Ausgabematrix abgerufen werden soll.

Hinweis Wenn die Stimme an eine einzelne Zielstimme sendet, führt die Angabe von NULL dazu, dass GetOutputMatrix mit dieser Zielstimme arbeitet.

[in] SourceChannels

Bestätigt die Ausgabekanalanzahl der Stimme. Dies ist die Anzahl der Kanäle, die vom letzten Effekt in der Kette erzeugt werden.

[in] DestinationChannels

Bestätigt die Anzahl der Eingabekanäle der Zielstimme.

[out] pLevelMatrix

Array von [SourceChannels * DestinationChannels]-Lautstärken, die an die Zielstimme gesendet werden. Die vom Quellkanal S zum Zielkanal D gesendete Ebene wird im Format pLevelMatrix[DestinationChannels × S + D] zurückgegeben. Weitere Informationen zu Lautstärkeebenen finden Sie unter Hinweise.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Diese Methode gilt nur für Quell- und Submixstimmen, da Masteringstimmen ohne Matrixmischung direkt auf das Gerät schreiben.

Volumenpegel werden als Gleitkommaamplitamplitsmultiplikatoren zwischen -2²⁴ und 2²⁴ mit einer maximalen Verstärkung von 144,5 dB ausgedrückt. Ein Lautstärkepegel von 1 bedeutet, dass es keine Dämpfung oder Verstärkung gibt, und 0 bedeutet Stille. Negative Werte können verwendet werden, um die Audiophase umzukehren. Weitere Informationen zur Lautstärkeregelung finden Sie unter XAudio2-Lautstärke- und Tonhöhensteuerung .

Informationen zur Standardkanalreihenfolge finden Sie unter WAVEFORMATEXTENSIBLE .

HinweisGetOutputMatrix gibt immer die Zuletzt von IXAudio2Voice::SetOutputMatrix festgelegten Ebenen zurück. Sie sind jedoch möglicherweise noch nicht wirksam: Sie werden nur wirksam, wenn die Audio-Engine das nächste Mal nach dem IXAudio2Voice::SetOutputMatrix-Aufruf ausgeführt wird (oder nach dem entsprechenden IXAudio2::CommitChanges-Aufruf , wenn IXAudio2Voice::SetOutputMatrix mit einer verzögerten Vorgangs-ID aufgerufen wurde).

Plattformanforderungen

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	xaudio2.h

Weitere Informationen

IXAudio2Voice

Freigeben über