Interfaces de audio principales

  • Artículo

Esta referencia de programación para core Audio SDK incluye las siguientes interfaces:

MMDevice API

La API de dispositivos multimedia de Windows (MMDevice) permite a los clientes de audio detectar dispositivos de punto de conexión de audio, determinar sus funcionalidades y crear instancias de controlador para esos dispositivos. El archivo de encabezado Mmdeviceapi.h define las interfaces de la API MMDevice. Para obtener más información, consulte Acerca de MMDevice API.

En la tabla siguiente se enumeran las interfaces MMDevice disponibles con core Audio SDK para Windows Vista.

Interfaz Descripción
IMMDevice Representa un dispositivo de audio.
IMMDeviceCollection Representa una colección de dispositivos de audio.
IMMDeviceEnumerator Proporciona métodos para enumerar dispositivos de audio.
IMMEndpoint Representa un dispositivo de punto de conexión de audio.
IMMNotificationClient Proporciona notificaciones cuando se agrega o quita un dispositivo de punto de conexión de audio, cuando cambia el estado o las propiedades de un dispositivo, o cuando hay un cambio en el rol predeterminado asignado a un dispositivo.

WASAPI

La API de sesión de audio de Windows (WASAPI) permite a las aplicaciones cliente administrar el flujo de datos de audio entre la aplicación y un dispositivo de punto de conexión de audio. Los archivos de encabezado Audioclient.h y Audiopolicy.h definen las interfaces WASAPI. Para obtener más información, consulte Acerca de WASAPI.

En la tabla siguiente se enumeran las interfaces WASAPI disponibles con core Audio SDK para Windows Vista y versiones posteriores.

Interfaz Descripción
IActivateAudioInterfaceAsyncOperation Representa una operación asincrónica que activa una interfaz WASAPI y proporciona un método para recuperar los resultados de la activación.
Se aplica a partir de Windows 8.
IActivateAudioInterfaceCompletionHandler Proporciona una devolución de llamada para indicar que la activación de una interfaz WASAPI está completa.
Se aplica a partir de Windows 8.
IAudioCaptureClient Permite a un cliente leer datos de entrada de un búfer de punto de conexión de captura.
IAudioClient Permite a un cliente crear e inicializar una secuencia de audio entre una aplicación de audio y el motor de audio o el búfer de hardware de un dispositivo de punto de conexión de audio.
IAudioClock Permite a un cliente supervisar la velocidad de datos de una secuencia y la posición actual en la secuencia.
IAudioClock2
 Permite a un cliente obtener la posición actual del dispositivo.
IAudioClockAdjustment
 Permite a un cliente establecer la frecuencia de muestreo de una secuencia.
IAudioRenderClient Permite a un cliente escribir datos de salida en un búfer de punto de conexión de representación.
IAudioSessionControl Permite a un cliente configurar los parámetros de control para una sesión de audio y supervisar eventos en la sesión.
IAudioSessionControl2
 Permite a un cliente obtener información sobre la sesión de audio.
IAudioSessionManager Permite a un cliente acceder a los controles de sesión y a los controles de volumen para sesiones de audio específicas del proceso y entre procesos.
IAudioSessionManager2
 Administra todas las submezclas, incluida la enumeración y la notificación de submezclas. También proporciona compatibilidad con notificaciones de pato.
IAudioSessionEnumerator
 Permite a un cliente enumerar sesiones de audio.
IAudioStreamVolume Permite a un cliente controlar y supervisar los niveles de volumen de todos los canales de una secuencia de audio.
IChannelAudioVolume Permite a un cliente controlar los niveles de volumen de todos los canales de la sesión de audio a la que pertenece la secuencia.
ISimpleAudioVolume Permite a un cliente controlar el nivel de volumen maestro de una sesión de audio.
IAudioSessionEvents Proporciona notificaciones de eventos relacionados con la sesión, como cambios en el nivel de volumen, el nombre para mostrar y el estado de sesión.
IAudioSessionNotification
 Envía notificaciones cuando se producen cambios en la sesión.
IAudioVolumeDuckNotification
 Envía notificaciones sobre los cambios pendientes de pato del sistema.

DeviceTopology API

La API DeviceTopology proporciona a las aplicaciones cliente la capacidad de recorrer las topologías de hardware funcionales de los dispositivos de representación y captura de audio. El archivo de encabezado Devicetopology.h define las interfaces de la API DeviceTopology. Para más información, consulte Topologías de dispositivos y API deviceTopology.

En la tabla siguiente se enumeran las interfaces deviceTopology disponibles con core Audio SDK para Windows Vista y versiones posteriores.

Interfaz Descripción
IAudioAutoGainControl Proporciona acceso a un control automático de ganancia de hardware (AGC).
IAudioBass Proporciona acceso a un control de bajo de hardware.
IAudioChannelConfig Proporciona acceso a un control de configuración de canal de hardware.
IAudioInputSelector Proporciona acceso a un control de multiplexador de hardware (selector de entrada).
IAudioLoudness Proporciona acceso a un control de compensación de "voz alta".
IAudioMidrange Proporciona acceso a un control de nivel medio de hardware.
IAudioMute Proporciona acceso a un control de exclusión de hardware.
IAudioOutputSelector Proporciona acceso a un control de demultiplexer de hardware (selector de salida).
IAudioPeakMeter Proporciona acceso a un control de medidor máximo de hardware.
IAudioTreble Proporciona acceso a un control de nivel de treble de hardware.
IAudioVolumeLevel Proporciona acceso a un control de volumen de hardware.
IConnector Representa un punto de conexión entre componentes.
IControlInterface Representa una interfaz de control de una parte (subunidad o conector).
IDeviceSpecificProperty Representa una propiedad específica del dispositivo de un conector o subunidad.
IDeviceTopology Proporciona acceso a la topología de un dispositivo de audio.
IKsFormatSupport Proporciona información sobre los formatos de datos de audio compatibles con una conexión de E/S configurada por software (normalmente un canal DMA) entre el dispositivo de audio y la memoria del sistema.
IKsJackDescription Proporciona información sobre los conectores o conectores internos que proporcionan una conexión física entre un dispositivo en un adaptador de audio y un dispositivo de punto de conexión externo o interno (por ejemplo, un micrófono o reproductor de CD).
IKsJackDescription2
 Proporciona un acceso cómodo a la propiedad KSPROPERTY_JACK_DESCRIPTION2 de un conector a un dispositivo de punto de conexión.
IKsJackSinkInformation
 Proporciona información sobre el receptor del conector si el conector es compatible con el hardware.
IPart Representa una parte (conector o subunit) de una topología de dispositivo.
IPartsList Representa una lista de elementos (conectores y subunidades).
IPerChannelDbLevel Representa una interfaz de control de subunidad genérica que proporciona control por canal sobre el nivel de volumen, en decibelios, de una secuencia de audio o de una banda de frecuencia en una secuencia de audio.
ISubunit Representa una subunidad de hardware (por ejemplo, un control de nivel de volumen) que se encuentra en la ruta de acceso de datos entre un cliente y un dispositivo de punto de conexión de audio.
IControlChangeNotify Proporciona notificaciones cuando cambia el estado de un elemento (conector o subunidad).

EndpointVolume API

La API EndpointVolume permite a los clientes especializados controlar y supervisar los niveles de volumen de los dispositivos de punto de conexión de audio. El archivo de encabezado Endpointvolume.h define las interfaces de la API EndpointVolume. Para obtener más información, consulte EndpointVolume API .

En la tabla siguiente se enumeran las interfaces EndpointVolume disponibles con core Audio SDK para Windows Vista.

Interfaz Descripción
IAudioEndpointVolume Representa los controles de volumen de la secuencia de audio hacia o desde un dispositivo de punto de conexión de audio.
IAudioEndpointVolumeEx
 Proporciona controles de volumen en la secuencia de audio hacia o desde un punto de conexión de dispositivo.
IAudioMeterInformation Representa un medidor máximo en la secuencia de audio hacia o desde un dispositivo de punto de conexión de audio.
IAudioEndpointVolumeCallback Proporciona notificaciones cuando cambia el estado de silenciamiento o nivel de volumen de un dispositivo de punto de conexión de audio.

Referencia de programación