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 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 IMMDevice Interface, obtenga una referencia a la interfaz 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.

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 IAudioClient , consulte los temas siguientes:

• Representación de un Stream
• Captura de un Stream
• Secuencias en modo exclusivo

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.

Comentarios

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	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

Interfaces de audio principales

IMMDevice::Activate

WASAPI