ISpatialAudioObjectRenderStreamBase::Reset-Methode (spatialaudioclient.h)

Setzen Sie einen beendeten Audiodatenstrom zurück.

Syntax

HRESULT Reset();

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
SPTLAUDCLNT_E_STREAM_NOT_STOPPED
Der Audiodatenstrom wurde nicht beendet. Beenden Sie den Stream, indem Sie Stop aufrufen.
SPTLAUDCLNT_E_DESTROYED
Der dem räumlichen Audiostream zugeordnete ISpatialAudioClient wurde zerstört.
AUDCLNT_E_DEVICE_INVALIDATED
Das Audioendpunktgerät wurde nicht angeschlossen, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig nicht mehr verfügbar gemacht.
SPTLAUDCLNT_E_INTERNAL
Ein interner Fehler ist aufgetreten.
AUDCLNT_E_UNSUPPORTED_FORMAT
Die Dem räumlichen Audiostream zugeordneten Medien verwenden ein nicht unterstütztes Format.

Hinweise

Beim Zurücksetzen des Audiodatenstroms werden alle ausstehenden Daten geleert und die Position des Audiouhrstreams auf 0 zurückgesetzt. Durch das Zurücksetzen des Datenstroms werden auch alle aktiven ISpatialAudioObject-Instanzen widerrufen.
Ein nachfolgender Aufruf von Start bewirkt, dass der Stream an der Position 0 beginnt.

Der Stream muss zuvor mit einem Aufruf von Stop beendet worden sein, andernfalls schlägt die Methode fehl und gibt SPTLAUDCLNT_E_STREAM_NOT_STOPPED zurück.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile spatialaudioclient.h

Weitere Informationen

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase