IAudioClient::Reset-Methode (audioclient.h)

  • Artikel

Die Reset-Methode setzt den Audiodatenstrom zurück.

Syntax

HRESULT Reset();

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode erfolgreich ist und der Stream bereits zurückgesetzt wurde, gibt die Methode S_FALSE zurück. 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
AUDCLNT_E_NOT_INITIALIZED
 Der Audiodatenstrom wurde nicht erfolgreich initialisiert.
AUDCLNT_E_NOT_STOPPED
 Der Audiodatenstrom wurde zum Zeitpunkt des Anrufs nicht beendet.
AUDCLNT_E_BUFFER_OPERATION_PENDING
 Der Client schreibt derzeit in den Puffer oder liest aus dem Puffer.
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 erfolgreichen Aufruf der IAudioClient::Initialize-Methode initialisiert .

Zurücksetzen ist eine Steuerungsmethode, die der Client aufruft, um einen beendeten Audiodatenstrom zurückzusetzen. Beim Zurücksetzen des Datenstroms werden alle ausstehenden Daten geleert und die Position des Audiouhrdatenstroms auf 0 zurückgesetzt. Diese Methode schlägt fehl, wenn sie für einen Stream aufgerufen wird, der nicht beendet wird.

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