IXAudio2VoiceCallback::OnBufferStart-Methode (xaudio2.h)

Artikel
03/04/2024

Wird aufgerufen, wenn die Stimme mit der Verarbeitung eines neuen Audiopuffers beginnt.

Syntax

void OnBufferStart(
  void *pBufferContext
);

Parameter

pBufferContext

Kontextzeiger, der dem pContext-Member der XAUDIO2_BUFFER-Struktur zugewiesen wurde, als der Puffer übermittelt wurde.

Rückgabewert

Keine

Bemerkungen

pBufferContext ist der Kontextzeiger, der ursprünglich vom pContext-Member der XAUDIO2_BUFFER-Struktur bereitgestellt wurde, der möglicherweise NULL sein kann.

OnBufferStart wird garantiert aufgerufen, bevor das erste Byte des aktuellen Puffers verbraucht wird. Es empfiehlt sich, diesen Rückruf für Änderungen am Sprachzustand wie die folgenden zu verwenden.

Übermitteln eines neuen Puffers an die Stimme
Anpassen der Lautstärke-, Tonhöhen- und Effektparameter der Stimme
Aktivieren oder Deaktivieren eines Effekts in der Effektkette der Stimme

Alle oben aufgeführten Aktionen sind synchron, wenn sie in einem XAudio2-Rückruf ausgeführt werden, sodass die Änderungen sofort wirksam werden, was sich auf den Puffer auswirkt, der gerade gestartet wird.

Es ist auch sicher, diesen Rückruf zu verwenden, um Audiodaten direkt in den Puffer zu schreiben, was für Streamingszenarien mit geringer Latenz nützlich sein kann. Wie bei allen XAudio2-Rückrufen sollte jedoch keine Arbeit ausgeführt werden, die eine erhebliche Menge an Prozessorzeit benötigt oder die Ausführung blockieren könnte, einschließlich synchroner Datenträger- oder Netzwerklesevorgänge.

Informationen zu den Methoden der IXAudio2VoiceCallback-Schnittstelle finden Sie im Abschnitt XAudio2-Rückrufe .