Partager via

Interfaces audio principales

  • Article

Cette référence de programmation pour le Kit de développement logiciel (SDK) Core Audio inclut les interfaces suivantes :

MMDevice API

L’API MMDevice (Windows Multimedia Device) permet aux clients audio de découvrir les appareils de point de terminaison audio, de déterminer leurs fonctionnalités et de créer des instances de pilotes pour ces appareils. Le fichier d’en-tête Mmdeviceapi.h définit les interfaces dans l’API MMDevice. Pour plus d’informations, consultez À propos de l’API MMDevice.

Le tableau suivant répertorie les interfaces MMDevice disponibles avec le Kit de développement logiciel (SDK) Core Audio pour Windows Vista.

Interface Description
IMMDevice Représente un périphérique audio.
IMMDeviceCollection Représente une collection d’appareils audio.
IMMDeviceEnumerator Fournit des méthodes pour énumérer les périphériques audio.
IMMEndpoint Représente un appareil de point de terminaison audio.
IMMNotificationClient Fournit des notifications lorsqu’un appareil de point de terminaison audio est ajouté ou supprimé, lorsque l’état ou les propriétés d’un appareil changent ou lorsqu’il y a une modification dans le rôle par défaut attribué à un appareil.

WASAPI

L’API de session audio Windows (WASAPI) permet aux applications clientes de gérer le flux de données audio entre l’application et un appareil de point de terminaison audio. Les fichiers d’en-tête Audioclient.h et Audiopolicy.h définissent les interfaces WASAPI. Pour plus d’informations, consultez À propos de WASAPI.

Le tableau suivant répertorie les interfaces WASAPI disponibles avec le Kit de développement logiciel (SDK) Core Audio pour Windows Vista et versions ultérieures.

Interface Description
IActivateAudioInterfaceAsyncOperation Représente une opération asynchrone activant une interface WASAPI et fournit une méthode pour récupérer les résultats de l’activation.
S’applique à partir de Windows 8.
IActivateAudioInterfaceCompletionHandler Fournit un rappel pour indiquer que l’activation d’une interface WASAPI est terminée.
S’applique à partir de Windows 8.
IAudioCaptureClient Permet à un client de lire les données d’entrée à partir d’une mémoire tampon de point de terminaison de capture.
IAudioClient Permet à un client de créer et d’initialiser un flux audio entre une application audio et le moteur audio ou la mémoire tampon matérielle d’un périphérique de point de terminaison audio.
IAudioClock Permet à un client de surveiller le débit de données d’un flux et la position actuelle dans le flux.
IAudioClock2
 Permet à un client d’obtenir la position actuelle de l’appareil.
IAudioClockAdjustment
 Permet à un client de définir le taux d’échantillonnage d’un flux.
IAudioRenderClient Permet à un client d’écrire des données de sortie dans une mémoire tampon de point de terminaison de rendu.
IAudioSessionControl Permet à un client de configurer les paramètres de contrôle d’une session audio et de surveiller les événements de la session.
IAudioSessionControl2
 Permet à un client d’obtenir des informations sur la session audio.
IAudioSessionManager Permet à un client d’accéder aux contrôles de session et aux contrôles de volume pour les sessions audio inter-processus et spécifiques au processus.
IAudioSessionManager2
 Gère tous les sous-mélanges, y compris l’énumération et la notification des sous-mélanges. Il prend également en charge les notifications de canardage.
IAudioSessionEnumerator
 Permet à un client d’énumérer les sessions audio.
IAudioStreamVolume Permet à un client de contrôler et de surveiller les niveaux de volume de tous les canaux d’un flux audio.
IChannelAudioVolume Permet à un client de contrôler les niveaux de volume pour tous les canaux de la session audio à laquelle appartient le flux.
ISimpleAudioVolume Permet à un client de contrôler le master niveau de volume d’une session audio.
IAudioSessionEvents Fournit des notifications d’événements liés à la session, tels que les modifications apportées au niveau du volume, au nom d’affichage et à l’état de la session.
IAudioSessionNotification
 Envoie des notifications lorsque des modifications de session se produisent.
IAudioVolumeDuckNotification
 Envoie des notifications concernant les modifications du système en attente.

DeviceTopology API

L’API DeviceTopology permet aux applications clientes de parcourir les topologies matérielles fonctionnelles des appareils de rendu et de capture audio. Le fichier d’en-tête Devicetopology.h définit les interfaces dans l’API DeviceTopology. Pour plus d’informations, consultez Topologies d’appareils et API DeviceTopology.

Le tableau suivant répertorie les interfaces DeviceTopology disponibles avec le Kit de développement logiciel (SDK) Core Audio pour Windows Vista et versions ultérieures.

Interface Description
IAudioAutoGainControl Fournit l’accès à un contrôle de gain automatique (AGC) matériel.
IAudioBass Fournit l’accès à un contrôle de niveau de base matériel.
IAudioChannelConfig Fournit l’accès à un contrôle de configuration de canal matériel.
IAudioInputSelector Fournit l’accès à un contrôle de multiplexeur matériel (sélecteur d’entrée).
IAudioLoudness Fournit l’accès à un contrôle de compensation « loudness ».
IAudioMidrange Fournit l’accès à un contrôle matériel de niveau milieu de gamme.
IAudioMute Fournit l’accès à un contrôle de sourdine matériel.
IAudioOutputSelector Fournit l’accès à un contrôle de démultiplexeur matériel (sélecteur de sortie).
IAudioPeakMeter Fournit l’accès à un contrôle de compteur de pointe matériel.
IAudioTreble Fournit l’accès à un contrôle de niveau triple matériel.
IAudioVolumeLevel Fournit l’accès à un contrôle de volume matériel.
IConnector Représente un point de connexion entre les composants.
IControlInterface Représente une interface de contrôle sur une partie (sous-unité ou connecteur).
IDeviceSpecificProperty Représente une propriété spécifique à l’appareil d’un connecteur ou d’une sous-unité.
IDeviceTopology Fournit l’accès à la topologie d’un appareil audio.
IKsFormatSupport Fournit des informations sur les formats de données audio pris en charge par une connexion d’E/S configurée par logiciel (généralement un canal DMA) entre le périphérique audio et la mémoire système.
IKsJackDescription Fournit des informations sur les prises jack ou les connecteurs internes qui fournissent une connexion physique entre un appareil sur une carte audio et un périphérique de point de terminaison externe ou interne (par exemple, un microphone ou un lecteur CD).
IKsJackDescription2
 Fournit un accès pratique à la propriété KSPROPERTY_JACK_DESCRIPTION2 d’un connecteur à un appareil de point de terminaison.
IKsJackSinkInformation
 Fournit des informations sur le récepteur jack si la prise en charge est prise en charge par le matériel.
IPart Représente une partie (connecteur ou sous-unité) d’une topologie d’appareil.
IPartsList Représente une liste de parties (connecteurs et sous-unités).
IPerChannelDbLevel Représente une interface de contrôle de sous-unité générique qui fournit un contrôle par canal sur le niveau de volume, en décibels, d’un flux audio ou d’une bande de fréquences dans un flux audio.
ISubunit Représente une sous-unité matérielle (par exemple, un contrôle au niveau du volume) qui se trouve dans le chemin des données entre un client et un périphérique de point de terminaison audio.
IControlChangeNotify Fournit des notifications lorsque le status d’une partie (connecteur ou sous-unité) change.

EndpointVolume API

L’API EndpointVolume permet aux clients spécialisés de contrôler et de surveiller les niveaux de volume des appareils de point de terminaison audio. Le fichier d’en-tête Endpointvolume.h définit les interfaces dans l’API EndpointVolume. Pour plus d’informations, consultez API EndpointVolume .

Le tableau suivant répertorie les interfaces EndpointVolume disponibles avec le Kit de développement logiciel (SDK) Core Audio pour Windows Vista.

Interface Description
IAudioEndpointVolume Représente les contrôles de volume sur le flux audio vers ou à partir d’un appareil de point de terminaison audio.
IAudioEndpointVolumeEx
 Fournit des contrôles de volume sur le flux audio vers ou à partir d’un point de terminaison d’appareil.
IAudioMeterInformation Représente un compteur de pointe sur le flux audio vers ou à partir d’un appareil de point de terminaison audio.
IAudioEndpointVolumeCallback Fournit des notifications lorsque le niveau de volume ou l’état de désactivation d’un appareil de point de terminaison audio change.

Guide de référence de programmation