IXAudio2::CreateSubmixVoice-Methode (xaudio2.h)

Erstellt und konfiguriert eine Submixstimme.

Syntax

HRESULT CreateSubmixVoice(
  [out]          IXAudio2SubmixVoice        **ppSubmixVoice,
  [in]           UINT32                     InputChannels,
  [in]           UINT32                     InputSampleRate,
  [in]           UINT32                     Flags,
  [in]           UINT32                     ProcessingStage,
  [in, optional] const XAUDIO2_VOICE_SENDS  *pSendList,
  [in, optional] const XAUDIO2_EFFECT_CHAIN *pEffectChain
);

Parameter

[out] ppSubmixVoice

Gibt bei Erfolg einen Zeiger auf das neue IXAudio2SubmixVoice-Objekt zurück.

[in] InputChannels

Anzahl der Kanäle in den Audioeingabedaten der Submixstimme. InputChannels muss kleiner oder gleich XAUDIO2_MAX_AUDIO_CHANNELS sein.

[in] InputSampleRate

Abtastrate der Audioeingabedaten der Submixstimme. Diese Rate muss ein Vielfaches von XAUDIO2_QUANTUM_DENOMINATOR sein. InputSampleRate muss zwischen XAUDIO2_MIN_SAMPLE_RATE und XAUDIO2_MAX_SAMPLE_RATE sein.

[in] Flags

Flags, die das Verhalten der Submixstimme angeben. Dies kann 0 oder folgendes sein:

[in] ProcessingStage

Eine beliebige Zahl, die angibt, wann diese Stimme in Bezug auf andere Submixstimme verarbeitet wird, wenn die XAudio2-Engine andere Submixstimme ausführt. Die Stimme wird nach allen anderen Stimmen verarbeitet, die einen kleineren ProcessingStage-Wert enthalten, und vor allen anderen Stimmen, die einen größeren ProcessingStage-Wert enthalten. Stimmen, die denselben ProcessingStage-Wert enthalten, werden in beliebiger Reihenfolge verarbeitet. Eine Submixstimme kann nicht an eine andere Submixstimme mit einem niedrigeren oder gleichen ProcessingStage-Wert senden. Dadurch wird verhindert, dass Audio aufgrund eines Submixzyklus verloren geht.

[in, optional] pSendList

Zeiger auf eine Liste von XAUDIO2_VOICE_SENDS Strukturen, die den Satz der Zielstimme für die Submixstimme beschreiben. Wenn pSendList NULL ist, wird in der Sendeliste standardmäßig eine einzelne Ausgabe an die erste erstellte Masterstimme ausgegeben.

[in, optional] pEffectChain

Zeiger auf eine Liste von XAUDIO2_EFFECT_CHAIN Strukturen, die eine Effektkette beschreiben, die in der Submixstimme verwendet werden soll.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. andernfalls ein Fehlercode.

Beschreibungen von XAudio2-spezifischen Fehlercodes finden Sie unter XAudio2-Fehlercodes.

Hinweise

Submix-Stimmen erhalten die Ausgabe einer oder mehrerer Quell- oder Submix-Stimmen. Sie verarbeiten die Ausgabe und senden sie dann an eine andere Submixstimme oder an eine Masterstimme.

Eine Submixstimme führt eine Konvertierung der Abtastrate von der Eingabe-Abtastrate in die Eingaberate ihrer Ausgabestimme in pSendList durch. Wenn Sie mehrere Sprachsendungen angeben, müssen alle über die gleiche Abtastrate verfügen.

Sie können keine Quell- oder Submixstimme erstellen, bis eine Masterstimme vorhanden ist, und Sie können eine Masterstimme nicht zerstören, wenn noch Quell- oder Submixstimme vorhanden ist.

Bei der ersten Erstellung befinden sich Submix-Stimmen im Startzustand.

XAudio2 verwendet einen internen Speicherpooler für Stimmen im gleichen Format. Dies bedeutet, dass die Speicherbelegung für Stimmen seltener auftritt, da mehr Stimmen erstellt und dann zerstört werden. Um Just-in-Time-Zuordnungen zu minimieren, kann ein Titel die erwartete maximale Anzahl von Stimmen erstellen, die im Voraus benötigt werden, und diese dann nach Bedarf löschen. Stimmen werden dann aus dem XAudio2-Pool wiederverwendet. Der Speicherpool ist an eine XAudio2-Engine instance gebunden. Sie können den gesamten Von einem instance der XAudio2-Engine verwendeten Arbeitsspeicher wieder freigeben, indem Sie das XAudio2-Objekt zerstören und es bei Bedarf neu erstellen (erzwingen, dass der Arbeitsspeicherpool über eine Vorbelegung vergrößert werden muss, muss bei Bedarf erneut angewendet werden).

Es ist ungültig, CreateSubmixVoice innerhalb eines Rückrufs aufzurufen (also IXAudio2EngineCallback oder IXAudio2VoiceCallback). Wenn Sie CreateSubmixVoice innerhalb eines Rückrufs aufrufen, wird XAUDIO2_E_INVALID_CALL zurückgegeben.

Die XAUDIO2_EFFECT_CHAIN , die als pEffectChain-Argument übergeben wird, und alle darin enthaltenen XAUDIO2_EFFECT_DESCRIPTOR Informationen werden nach dem erfolgreichen Abschluss von CreateSubmixVoice nicht mehr benötigt und können unmittelbar nach dem Aufruf von CreateSubmixVoice gelöscht werden.

Plattformanforderungen

Anforderungen

Weitere Informationen

IXAudio2

XAudio2-Abtastratekonvertierungen