Interfaz IAudioClient (audioclient.h)

La interfaz IAudioClient permite a un cliente crear e inicializar una secuencia de audio entre una aplicación de audio y el motor de audio (para una secuencia en modo compartido) o el búfer de hardware de un dispositivo de punto de conexión de audio (para una secuencia en modo exclusivo). Un cliente obtiene una referencia a una interfaz de IAudioClient para un dispositivo de punto de conexión de audio siguiendo estos pasos:

1. Mediante el uso de una de las técnicas descritas en interfaz IMMDevice, obtenga una referencia a la interfaz de IMMDevice para un dispositivo de punto de conexión de audio.
2. Llame al método IMMDevice::Activate con el parámetro iid establecido en REFIID IID_IAudioClient. A partir de la compilación 20348 de Windows 10, los autores de llamadas pueden pasar una AUDIOCLIENT_ACTIVATION_PARAMS para configurar el IAudioClient de para la captura de bucle invertido con un filtro de proceso.

El subproceso de aplicación que usa esta interfaz debe inicializarse para COM. Para obtener más información sobre la inicialización COM, vea la descripción de la función CoInitializeEx en la documentación de Windows SDK.

Para obtener ejemplos de código que usan la interfaz de IAudioClient, consulte los temas siguientes:

• representación de un flujo
• capturar un de flujo
• streams de Exclusive-Mode

Herencia

La interfaz IAudioClient hereda de la interfaz IUnknown. IAudioClient también tiene estos tipos de miembros:

Métodos

La interfaz IAudioClient tiene estos métodos.

IAudioClient::GetBufferSize El método GetBufferSize recupera el tamaño (capacidad máxima) del búfer del punto de conexión.
IAudioClient::GetCurrentPadding El método GetCurrentPadding recupera el número de fotogramas de relleno en el búfer del punto de conexión.
IAudioClient::GetDevicePeriod El método GetDevicePeriod recupera la longitud del intervalo periódico que separa los pasos de procesamiento sucesivos por el motor de audio en los datos del búfer del punto de conexión.
IAudioClient::GetMixFormat El método GetMixFormat recupera el formato de secuencia que usa el motor de audio para su procesamiento interno de secuencias en modo compartido.
IAudioClient::GetService El método GetService accede a servicios adicionales desde el objeto de cliente de audio.
IAudioClient::GetStreamLatency El método GetStreamLatency recupera la latencia máxima para la secuencia actual y se puede llamar a cualquier momento después de inicializar la secuencia.
IAudioClient::Initialize El método Initialize inicializa la secuencia de audio.
IAudioClient::IsFormatSupported El método IsFormatSupported indica si el dispositivo de punto de conexión de audio admite un formato de secuencia determinado.
IAudioClient::Reset El método Reset restablece la secuencia de audio.
IAudioClient::SetEventHandle El método SetEventHandle establece el identificador de eventos que indica el sistema cuando el cliente está listo para procesar un búfer de audio.
IAudioClient::Start El método Start inicia la secuencia de audio.
IAudioClient::Stop El método Stop detiene la secuencia de audio.

Observaciones

Nota En Windows 8, el primer uso de IAudioClient para acceder al dispositivo de audio debe estar en el subproceso STA. Las llamadas desde un subproceso de MTA pueden dar lugar a un comportamiento indefinido.

 

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	audioclient.h

Consulte también

interfaces de audio principales

IMMDevice::Activate

WASAPI