IAudioClient::Start-Methode (audioclient.h)
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 |
|---|---|
|
Der Audiostream wurde nicht erfolgreich initialisiert. |
|
Der Audiostream wurde zum Zeitpunkt des Startaufrufs nicht beendet. |
|
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. |
|
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. |
|
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 |