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:

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