IAudioClient::Reset-Methode (audioclient.h)
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 |
|---|---|
|
Der Audiodatenstrom wurde nicht erfolgreich initialisiert. |
|
Der Audiodatenstrom wurde zum Zeitpunkt des Anrufs nicht beendet. |
|
Der Client schreibt derzeit in den Puffer oder liest aus dem Puffer. |
|
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 |