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
AUDCLNT_E_NOT_INITIALIZED
La secuencia de audio no se ha inicializado correctamente.
AUDCLNT_E_DEVICE_INVALIDATED
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.
AUDCLNT_E_SERVICE_NOT_RUNNING
El servicio de audio de Windows no se está ejecutando.
E_POINTER
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

Consulte también

IAudioClient (interfaz)

IAudioClient::Initialize

IAudioRenderClient::GetBuffer