IAudioClient::Start-Methode (audioclient.h)

  • Artikel

Die Start-Methode startet den Audiostream.

Syntax

HRESULT Start();

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. 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 Audiostream wurde nicht erfolgreich initialisiert.
AUDCLNT_E_NOT_STOPPED
 Der Audiostream wurde zum Zeitpunkt des Startaufrufs nicht beendet.
AUDCLNT_E_EVENTHANDLE_NOT_SET
 Der Audiostream ist für die Verwendung der ereignisgesteuerten Pufferung konfiguriert, aber der Aufrufer hat nicht IAudioClient::SetEventHandle aufgerufen, um das Ereignishandle für den Stream festzulegen.
AUDCLNT_E_DEVICE_INVALIDATED
 Das Audioendpunktgerät wurde getrennt, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig für die Verwendung nicht verfügbar gemacht.
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 .

Start ist eine Steuerungsmethode, die der Client aufruft, um den Audiostream zu starten. Das Starten des Datenstroms bewirkt, dass das IAudioClient-Objekt mit dem Streaming von Daten zwischen dem Endpunktpuffer und der Audio-Engine beginnt. Sie bewirkt auch, dass die Audiouhr des Datenstroms die Zählung von ihrer aktuellen Position aus fortsetzen kann.

Wenn diese Methode nach der Initialisierung des Datenstroms zum ersten Mal aufgerufen wird, beginnt der Datenstrompositionszähler des IAudioClient-Objekts bei 0. Andernfalls wird die Uhr von ihrer Position zum Zeitpunkt fortgesetzt, an dem der Stream zuletzt beendet wurde. Beim Zurücksetzen des Datenstroms wird die Streamposition wieder auf 0 zurückgesetzt.

Um Startstörungen mit Renderingstreams zu vermeiden, sollten Clients start erst aufrufen, wenn die Audio-Engine anfänglich mit Daten geladen wurde, indem sie die Methoden IAudioRenderClient::GetBuffer und IAudioRenderClient::ReleaseBuffer auf der Renderingschnittstelle aufrufen.

Codebeispiele, die die Start-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

IAudioRenderClient::GetBuffer

IAudioRenderClient::ReleaseBuffer