IXAudio2SourceVoice::SetSourceSampleRate-Methode (xaudio2.h)

Konfiguriert die Stimme neu, um Quelldaten mit einer anderen Abtastrate als die beim Erstellen der Stimme angegebene Rate zu nutzen.

Syntax

HRESULT SetSourceSampleRate(
  [in] UINT32 NewSourceSampleRate
);

Parameter

[in] NewSourceSampleRate

Die neue Abtastrate, mit der die Stimme die übermittelten Daten verarbeiten soll. Gültige Abtastraten sind 1kHz bis 200kHz.

Rückgabewert

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

Hinweise

Die SetSourceSampleRate-Methode unterstützt die Wiederverwendung von XAudio2-Stimmen, indem einer Stimme die Wiedergabe von Sounds mit einer Vielzahl von Sampleraten ermöglicht wird. Um SetSourceSampleRate verwenden zu können, muss die Stimme ohne die XAUDIO2_VOICE_NOPITCH- oder XAUDIO2_VOICE_NOSRC-Flags erstellt worden sein und darf derzeit keine Puffer in der Warteschlange enthalten.

Die typische Verwendung von SetSourceSampleRate ist die Unterstützung von Sprachpooling. Um z. B. sprachpools zu unterstützen, würde eine Anwendung alle Stimmen vorstellen, die sie verwenden soll. Wenn ein neuer Sound wiedergegeben wird, wählt die Anwendung eine inaktive Stimme aus, oder wählt , wenn alle Stimmen beschäftigt sind, die am wenigsten wichtige Stimme aus und ruft SetSourceSampleRate für die Stimme mit der Samplerate des neuen Sounds auf. Nachdem SetSourceSampleRate für die Stimme aufgerufen wurde, kann die Anwendung sofort mit der Übermittlung und Wiedergabe von Puffern mit der neuen Abtastrate beginnen. Dies ermöglicht es der Anwendung, den Mehraufwand für das häufige Erstellen und Zerstören von Stimmen während des Spiels zu vermeiden.

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

IXAudio2SourceVoice