IAudioClient::GetStreamLatency-Methode (audioclient.h)

Die GetStreamLatency-Methode ruft die maximale Latenz für den aktuellen Stream ab und kann jederzeit aufgerufen werden, nachdem der Stream initialisiert wurde.

Syntax

HRESULT GetStreamLatency(
  [out] REFERENCE_TIME *phnsLatency
);

Parameter

[out] phnsLatency

Zeiger auf eine REFERENCE_TIME Variable, in die die Methode einen Zeitwert schreibt, der die Latenz darstellt. Die Zeit wird in 100 Nanosekundeneinheiten ausgedrückt. Weitere Informationen zu REFERENCE_TIME finden Sie in der Dokumentation zum Windows SDK.

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_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.
E_POINTER	Parameter phnsLatency ist NULL.

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 .

Diese Methode ruft die maximale Latenz für den aktuellen Stream ab. Der Wert ändert sich für die Lebensdauer des IAudioClient-Objekts nicht.

Renderclients können diesen Latenzwert verwenden, um die minimale Datenmenge zu berechnen, die sie während eines einzelnen Verarbeitungsdurchlaufs schreiben können. Um weniger als dieses Minimum zu schreiben, besteht die Gefahr, dass Störungen in den Audiodatenstrom eingeführt werden. Weitere Informationen finden Sie unter IAudioRenderClient::GetBuffer.

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