Interface IAudioClient (audioclient.h)

L’interface IAudioClient permet à un client de créer et d’initialiser un flux audio entre une application audio et le moteur audio (pour un flux en mode partagé) ou la mémoire tampon matérielle d’un appareil de point de terminaison audio (pour un flux en mode exclusif). Un client obtient une référence à une interface IAudioClient pour un appareil de point de terminaison audio en procédant comme suit :

  1. En utilisant l’une des techniques décrites dans IMMDevice Interface, obtenez une référence à l’interface IMMDevice pour un appareil de point de terminaison audio.
  2. Appelez la méthode IMMDevice ::Activate avec le paramètre iid défini sur REFIID IID_IAudioClient.

Le thread d’application qui utilise cette interface doit être initialisé pour COM. Pour plus d’informations sur l’initialisation COM, consultez la description de la fonction CoInitializeEx dans la documentation du Kit de développement logiciel (SDK) Windows.

Pour obtenir des exemples de code qui utilisent l’interface IAudioClient , consultez les rubriques suivantes :

Héritage

L’interface IAudioClient hérite de l’interface IUnknown. IAudioClient a également les types de membres suivants :

Méthodes

L’interface IAudioClient possède ces méthodes.

 
IAudioClient ::GetBufferSize

La méthode GetBufferSize récupère la taille (capacité maximale) de la mémoire tampon du point de terminaison.
IAudioClient ::GetCurrentPadding

La méthode GetCurrentPadding récupère le nombre d’images de remplissage dans la mémoire tampon du point de terminaison.
IAudioClient ::GetDevicePeriod

La méthode GetDevicePeriod récupère la longueur de l’intervalle périodique qui sépare les passages de traitement successifs par le moteur audio sur les données dans la mémoire tampon du point de terminaison.
IAudioClient ::GetMixFormat

La méthode GetMixFormat récupère le format de flux que le moteur audio utilise pour son traitement interne des flux en mode partagé.
IAudioClient ::GetService

La méthode GetService accède à des services supplémentaires à partir de l’objet client audio.
IAudioClient ::GetStreamLatency

La méthode GetStreamLatency récupère la latence maximale du flux actuel et peut être appelée à tout moment après l’initialisation du flux.
IAudioClient ::Initialize

La méthode Initialize initialise le flux audio.
IAudioClient ::IsFormatSupported

La méthode IsFormatSupported indique si le périphérique de point de terminaison audio prend en charge un format de flux particulier.
IAudioClient ::Reset

La méthode Reset réinitialise le flux audio.
IAudioClient ::SetEventHandle

La méthode SetEventHandle définit le handle d’événement que le système signale lorsqu’une mémoire tampon audio est prête à être traitée par le client.
IAudioClient ::Start

La méthode Start démarre le flux audio.
IAudioClient ::Stop

La méthode Stop arrête le flux audio.

Remarques

Note Dans Windows 8, la première utilisation d’IAudioClient pour accéder au périphérique audio doit se trouver sur le thread STA. Les appels d’un thread MTA peuvent entraîner un comportement non défini.
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête audioclient.h

Voir aussi

Interfaces audio principales

IMMDevice ::Activate

WASAPI