Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Stop-Methode beendet den Audiodatenstrom.
Syntax
HRESULT Stop();
Rückgabewert
Wenn die Methode erfolgreich ist und den Stream beendet, gibt sie S_OK zurück. Wenn die Methode erfolgreich ist und der Stream bereits beendet wurde, gibt die Methode S_FALSE zurück. 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 Client wurde nicht erfolgreich initialisiert. |
|
Der Windows-Audiodienst wird nicht ausgeführt. |
Hinweise
Diese Methode erfordert eine vorherige Initialisierung der IAudioClient-Schnittstelle . Alle Aufrufe dieser Methode schlagen mit dem Fehler AUDCLNT_E_NOT_INITIALIZED fehl, bis der Client den Audiodatenstrom durch erfolgreiches Aufrufen der IAudioClient::Initialize-Methode initialisiert .
Stop ist eine Steuerungsmethode, die einen ausgeführten Audiodatenstrom beendet. Diese Methode verhindert, dass Daten über die Verbindung des Clients mit der Audio-Engine gestreamt werden. Das Beenden des Datenstroms friert die Audiouhr des Streams an seiner aktuellen Streamposition ein. Ein späterer Aufruf von IAudioClient::Start bewirkt, dass der Stream von dieser Position aus fortgesetzt wird. Bei Bedarf kann der Client die IAudioClient::Reset-Methode aufrufen, um die Position zurückzusetzen, während der Stream beendet wird.
Codebeispiele, die die Stop-Methode aufrufen, finden Sie in den folgenden Themen:
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | audioclient.h |