IAudioClient::Stop-Methode (audioclient.h)

  • Artikel

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
AUDCLNT_E_NOT_INITIALIZED
 Der Client wurde nicht erfolgreich initialisiert.
AUDCLNT_E_SERVICE_NOT_RUNNING
 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

Weitere Informationen

IAudioClient-Schnittstelle

IAudioClient::Initialize

IAudioClient::Reset

IAudioClient::Start