IXAudio2SourceVoice::SubmitSourceBuffer-Methode (xaudio2.h)

Fügt der Sprachwarteschlange einen neuen Audiopuffer hinzu.

Syntax

HRESULT SubmitSourceBuffer(
  [in] const XAUDIO2_BUFFER     *pBuffer,
  [in] const XAUDIO2_BUFFER_WMA *pBufferWMA
);

Parameter

[in] pBuffer

Zeiger auf eine XAUDIO2_BUFFER Struktur in die Warteschlange.

[in] pBufferWMA

Zeiger auf eine zusätzliche XAUDIO2_BUFFER_WMA Struktur, die beim Übermitteln von WMA-Daten verwendet wird.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück, andernfalls einen Fehlercode. Beschreibungen von XAudio2-spezifischen Fehlercodes finden Sie unter XAudio2-Fehlercodes.

Hinweise

Die Stimme verarbeitet und gibt die Puffer in der Warteschlange in der Reihenfolge ab, in der sie übermittelt wurden.

Die XAUDIO2_BUFFER-Struktur enthält Details zur Position und Größe des Audiopuffers, dem Teil des Puffers, der tatsächlich wiedergegeben werden soll, dem Schleifenbereich (falls vorhanden) und der Anzahl der Schleifen, dem Kontextzeiger, der in allen Rückrufen verwendet werden soll, die sich auf diesen Puffer beziehen, und ein optionales XAUDIO2_END_OF_STREAM Flag, das angibt, dass es sich um den letzten Puffer eines zusammenhängenden Sounds handelt.

Wenn die Stimme gestartet wurde und keine Puffer in die Warteschlange eingereiht sind, beginnt der neue Puffer sofort mit der Wiedergabe. Wenn die Stimme beendet wird, wird der Puffer der Warteschlange der Stimme hinzugefügt und beim Starten der Stimme wiedergegeben.

Wenn nur ein Teil des angegebenen Puffers wiedergegeben werden soll, können die Felder PlayBegin und PlayLength im XAUDIO2_BUFFER verwendet werden, um die region anzugeben, die wiedergegeben werden soll. Ein PlayLength-Wert von 0 bedeutet, dass der gesamte Puffer wiedergegeben wird (und in diesem Fall muss PlayBegin ebenfalls 0 sein).

Wenn der Puffer ganz oder teilweise in einer endlosen Schleife wiedergegeben werden soll, können die Felder LoopBegin, LoopLength und LoopCount in XAUDIO2_BUFFER verwendet werden, um die Merkmale des Schleifenbereichs anzugeben. Ein LoopBegin-Wert von XAUDIO2_NO_LOOP_REGION bedeutet, dass keine Schleifen ausgeführt werden sollen. In diesem Fall müssen LoopLength und LoopCount als 0 angegeben werden. Wenn ein Schleifenbereich angegeben wird, muss er nicht leer sein (LoopLength> 0), und die Schleifenanzahl muss zwischen 1 und XAUDIO2_MAX_LOOP_COUNT einschließlich liegen (oder XAUDIO2_LOOP_INFINITE, um eine Endlosschleife anzugeben, die nur endet, wenn IXAudio2SourceVoice::ExitLoop aufgerufen wird). Eine Schleifenanzahl von N bedeutet, N-Mal rückwärts zu überspringen, d. h. den Schleifenbereich N+1 mal wiederzugeben.

Wenn ein expliziter Wiedergabebereich angegeben wird, muss er innerhalb des angegebenen Audiopuffers beginnen und enden (oder, im komprimierten Fall, innerhalb der Gruppe von Beispielen, in die der Puffer decodiert wird). Darüber hinaus kann der Schleifenbereich nicht über das Ende der Wiedergaberegion hinaus enden.

Xbox 360
Für bestimmte Audioformate kann es zusätzliche Einschränkungen für die gültigen Endpunkte beliebiger Wiedergabe- oder Schleifenregionen geben. z. B. bei XMA-Puffern können die Regionen nur bei 128-Sample-Grenzen im decodierten Audio beginnen oder enden.

 

Der pBuffer-Zeiger kann sofort nach dem Aufrufen dieser Methode wiederverwendet oder freigegeben werden, aber die tatsächlichen Audiodaten, auf die von pBuffer verwiesen wird, müssen gültig bleiben, bis der Puffer von XAudio2 vollständig verbraucht wurde (was durch den IXAudio2VoiceCallback::OnBufferEnd-Rückruf angegeben wird).

Bis zu XAUDIO2_MAX_QUEUED_BUFFERS Puffer können jederzeit für eine Stimme in die Warteschlange gestellt werden.

SubmitSourceBuffer wird sofort wirksam, wenn von einem XAudio2-Rückruf mit einem OperationSet XAUDIO2_COMMIT_NOW aufgerufen wird.

Xbox 360
Diese Methode kann über einen Xbox-Systemthread aufgerufen werden (die meisten anderen XAudio2-Methoden können dies nicht). Es können jedoch maximal zwei Quellpuffer gleichzeitig von einem Systemthread übermittelt werden.

 

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

So wird's gemacht: Erstellen eines grundlegenden Audioverarbeitungsdiagramms

So wird's gemacht: Streamen von Sound von einem Datenträger

IXAudio2SourceVoice