Interfaces de áudio principais
Esta referência de programação para o Core Audio SDK inclui as seguintes interfaces:
MMDevice API
A API do Dispositivo Multimídia do Windows (MMDevice) permite que os clientes de áudio descubram dispositivos de ponto de extremidade de áudio, determinem seus recursos e criem instâncias de driver para esses dispositivos. O arquivo de cabeçalho Mmdeviceapi.h define as interfaces na API MMDevice. Para obter mais informações, consulte Sobre a API MMDevice.
A tabela a seguir lista as interfaces MMDevice disponíveis com o Core Audio SDK para Windows Vista.
| Interface | Descrição |
|---|---|
| IMMevice | Representa um dispositivo de áudio. |
| IMMDeviceCollection | Representa uma coleção de dispositivos de áudio. |
| IMMDeviceEnumerador | Fornece métodos para enumerar dispositivos de áudio. |
| IMMEndpoint | Representa um dispositivo de ponto de extremidade de áudio. |
| IMMNotificationClient | Fornece notificações quando um dispositivo de ponto de extremidade de áudio é adicionado ou removido, quando o estado ou as propriedades de um dispositivo são alterados ou quando há uma alteração na função padrão atribuída a um dispositivo. |
WASAPI
A WASAPI (API de Sessão de Áudio do Windows) permite que os aplicativos cliente gerenciem o fluxo de dados de áudio entre o aplicativo e um dispositivo de ponto de extremidade de áudio. Os arquivos de cabeçalho Audioclient.h e Audiopolicy.h definem as interfaces WASAPI. Para obter mais informações, consulte Sobre o WASAPI.
A tabela a seguir lista as interfaces WASAPI disponíveis com o Core Audio SDK para Windows Vista e posterior.
| Interface | Descrição |
|---|---|
| IActivateAudioInterfaceAsyncOperation | Representa uma operação assíncrona ativando uma interface WASAPI e fornece um método para recuperar os resultados da ativação. Aplica-se a partir do Windows 8. |
| IActivateAudioInterfaceCompletionHandler | Fornece um retorno de chamada para indicar que a ativação de uma interface WASAPI está concluída. Aplica-se a partir do Windows 8. |
| IAudioCaptureClient | Permite que um cliente leia dados de entrada de um buffer de ponto de extremidade de captura. |
| IAudioClient | Permite que um cliente crie e inicialize um fluxo de áudio entre um aplicativo de áudio e o mecanismo de áudio ou o buffer de hardware de um dispositivo de ponto de extremidade de áudio. |
| IAudioClock | Permite que um cliente monitore a taxa de dados de um fluxo e a posição atual no fluxo. |
| IAudioClock2 |
Permite que um cliente obtenha a posição atual do dispositivo. |
| IAudioClockAdjustment |
Permite que um cliente defina a taxa de amostragem de um fluxo. |
| IAudioRenderClient | Permite que um cliente grave dados de saída em um buffer de ponto de extremidade de renderização. |
| IAudioSessionControl | Permite que um cliente configure os parâmetros de controle para uma sessão de áudio e monitore eventos na sessão. |
| IAudioSessionControl2 |
Permite que um cliente obtenha informações sobre a sessão de áudio. |
| IAudioSessionManager | Permite que um cliente acesse os controles de sessão e os controles de volume para sessões de áudio entre processos e específicas do processo. |
| IAudioSessionManager2 |
Gerencia todas as submisturas, incluindo enumeração e notificação de submixes. Ele também fornece suporte para notificações de evasão. |
| IAudioSessionEnumerator |
Permite que um cliente enumere sessões de áudio. |
| IAudioStreamVolume | Permite que um cliente controle e monitore os níveis de volume de todos os canais em um fluxo de áudio. |
| IChannelAudioVolume | Permite que um cliente controle os níveis de volume de todos os canais na sessão de áudio à qual o fluxo pertence. |
| ISimpleAudioVolume | Permite que um cliente controle o nível de volume mestre de uma sessão de áudio. |
| IAudioSessionEventos | Fornece notificações de eventos relacionados à sessão, como alterações no nível de volume, nome para exibição e estado da sessão. |
| IAudioSessionNotification |
Envia notificações quando ocorrem alterações na sessão. |
| IAudioVolumeDuckNotification |
Envia notificações sobre alterações pendentes de desvio do sistema. |
DeviceTopology API
A API DeviceTopology fornece aos aplicativos cliente a capacidade de atravessar as topologias de hardware funcionais de dispositivos de renderização e captura de áudio. O arquivo de cabeçalho Devicetopology.h define as interfaces na API DeviceTopology. Para obter mais informações, consulte Topologias de dispositivo e API DeviceTopology.
A tabela a seguir lista as interfaces DeviceTopology disponíveis com o Core Audio SDK para Windows Vista e posterior.
| Interface | Descrição |
|---|---|
| IAudioAutoGainControl | Fornece acesso a um controle de ganho automático de hardware (AGC). |
| IAudioBass | Fornece acesso a um controle de nível de graves de hardware. |
| IAudioChannelConfig | Fornece acesso a um controle de configuração de canal de hardware. |
| IAudioInputSelector | Fornece acesso a um controle multiplexador de hardware (seletor de entrada). |
| IAudioLoudness | Fornece acesso a um controle de compensação de "loudness". |
| IAudioMidrange | Fornece acesso a um controle de nível intermediário de hardware. |
| IAudioMudo | Fornece acesso a um controle de mudo de hardware. |
| IAudioOutputSelector | Fornece acesso a um controle de demultiplexador de hardware (seletor de saída). |
| IAudioPeakMeter | Fornece acesso a um controle de medidor de pico de hardware. |
| IAudioTreble | Fornece acesso a um controle de nível agudo de hardware. |
| IAudioVolumeLevel | Fornece acesso a um controle de volume de hardware. |
| IConnector | Representa um ponto de conexão entre componentes. |
| IControlInterface | Representa uma interface de controle em uma peça (subunidade ou conector). |
| IDeviceSpecificProperty | Representa uma propriedade específica do dispositivo de um conector ou subunidade. |
| IDeviceTopologia | Fornece acesso à topologia de um dispositivo de áudio. |
| IKsFormatSupport | Fornece informações sobre os formatos de dados de áudio que são suportados por uma conexão de E/S configurada por software (normalmente um canal DMA) entre o dispositivo de áudio e a memória do sistema. |
| IKsJackDescrição | Fornece informações sobre as tomadas ou conectores internos que fornecem uma conexão física entre um dispositivo em um adaptador de áudio e um dispositivo de ponto de extremidade externo ou interno (por exemplo, um microfone ou CD player). |
| IKsJackDescription2 |
Fornece acesso conveniente à propriedade KSPROPERTY_JACK_DESCRIPTION2 de um conector para um dispositivo de ponto de extremidade. |
| IKsJackSinkInformações |
Fornece informações sobre o coletor de tomada se o conector for suportado pelo hardware. |
| Artesão | Representa uma parte (conector ou subunidade) de uma topologia de dispositivo. |
| IPartsList | Representa uma lista de peças (conectores e subunidades). |
| IPerChannelDbLevel | Representa uma interface de controle de subunidade genérica que fornece controle por canal sobre o nível de volume, em decibéis, de um fluxo de áudio ou de uma banda de frequência em um fluxo de áudio. |
| ISubunit | Representa uma subunidade de hardware (por exemplo, um controle de nível de volume) que fica no caminho de dados entre um cliente e um dispositivo de ponto de extremidade de áudio. |
| IControlChangeNotify | Fornece notificações quando o status de uma peça (conector ou subunidade) é alterado. |
EndpointVolume API
A API EndpointVolume permite que clientes especializados controlem e monitorem os níveis de volume de dispositivos de ponto de extremidade de áudio. O arquivo de cabeçalho Endpointvolume.h define as interfaces na API EndpointVolume. Para obter mais informações, consulte EndpointVolume API .
A tabela a seguir lista as interfaces EndpointVolume disponíveis com o Core Audio SDK para Windows Vista.
| Interface | Descrição |
|---|---|
| IAudioEndpointVolume | Representa os controles de volume no fluxo de áudio de ou para um dispositivo de ponto de extremidade de áudio. |
| IAudioEndpointVolumeEx |
Fornece controles de volume no fluxo de áudio de ou para um ponto de extremidade do dispositivo. |
| IAudioMeterInformation | Representa um medidor de pico no fluxo de áudio de ou para um dispositivo de ponto de extremidade de áudio. |
| IAudioEndpointVolumeCallback | Fornece notificações quando o nível de volume ou o estado de silenciamento de um dispositivo de ponto de extremidade de áudio é alterado. |