IAudioClient::Stop-Methode (audioclient.h)
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 |