Método IAudioClient::GetStreamLatency (audioclient.h)
El método GetStreamLatency recupera la latencia máxima de la secuencia actual y se puede llamar a cualquier momento después de inicializar la secuencia.
Sintaxis
HRESULT GetStreamLatency(
[out] REFERENCE_TIME *phnsLatency
);
Parámetros
[out] phnsLatency
Puntero a una variable REFERENCE_TIME en la que el método escribe un valor de tiempo que representa la latencia. El tiempo se expresa en unidades de 100 nanosegundos. Para obtener más información sobre REFERENCE_TIME, consulte la documentación de Windows SDK.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
La secuencia de audio no se ha inicializado correctamente. |
|
El dispositivo de punto de conexión de audio se ha desconectado o el hardware de audio o los recursos de hardware asociados se han reconfigurado, deshabilitado, quitado o dejado de estar disponible para su uso. |
|
El servicio de audio de Windows no se está ejecutando. |
|
El parámetro phnsLatency es NULL. |
Comentarios
Este método requiere inicialización previa de la interfaz IAudioClient . Todas las llamadas a este método producirán el error AUDCLNT_E_NOT_INITIALIZED hasta que el cliente inicialice la secuencia de audio llamando correctamente al método IAudioClient::Initialize .
Este método recupera la latencia máxima para la secuencia actual. El valor no cambiará durante la vigencia del objeto IAudioClient .
Los clientes de representación pueden usar este valor de latencia para calcular la cantidad mínima de datos que pueden escribir durante cualquier paso de procesamiento único. Para escribir menos de este mínimo, es arriesgarse a introducir problemas en la secuencia de audio. Para obtener más información, vea IAudioRenderClient::GetBuffer.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | audioclient.h |