ISpatialAudioObjectRenderStreamBase::Stop-Methode (spatialaudioclient.h)
Beendet einen ausgeführten Audiostream.
Syntax
HRESULT Stop();
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der dem räumlichen Audiostream zugeordnete ISpatialAudioClient wurde zerstört. |
|
Das Audioendpunktgerät wurde getrennt, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig für die Verwendung nicht verfügbar gemacht. |
|
Ein interner Fehler ist aufgetreten. |
|
Die dem räumlichen Audiostream zugeordneten Medien verwenden ein nicht unterstütztes Format. |
Hinweise
Das Beenden des Datenstroms führt dazu, dass die Daten nicht mehr zwischen dem Endpunktpuffer und der Audio-Engine fließen.
Sie können diesen Vorgang in Betracht ziehen, um den Stream anzuhalten, da die Audiouhr des Streams an der aktuellen Streamposition bleibt und nicht auf 0 zurückgesetzt wird. Ein nachfolgender Aufruf von Start bewirkt, dass der Stream von der aktuellen Position aus fortgesetzt wird.
Rufen Sie Reset auf, um die Uhrposition auf 0 zurückzusetzen und alle aktiven ISpatialAudioObject-Instanzen zu widerrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | spatialaudioclient.h |