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 |
|---|---|
|
Der Audiostream wurde nicht erfolgreich initialisiert. |
|
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. |
|
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 |