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 :
- En utilisant l’une des techniques décrites dans interface IMMDevice, obtenez une référence à l’interface IMMDevice pour un appareil de point de terminaison audio.
- Appelez la méthode IMMDevice ::Activate avec le paramètre iid défini sur REFIID IID_IAudioClient. À compter de Windows 10 Build 20348, les appelants peuvent passer un AUDIOCLIENT_ACTIVATION_PARAMS pour configurer les IAudioClient pour la capture de bouclage avec un filtre de processus.
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 :
- Rendu d’un de flux
- capturer un de flux
- Exclusive-Mode Streams
Héritage
L’interface IAudioClient hérite de l’interface IUnknown. IAudioClient possède également ces types de membres :
Méthode
L’interface IAudioClient a ces méthodes.
|
IAudioClient ::GetBufferSize La méthode GetBufferSize récupère la taille (capacité maximale) de la mémoire tampon de 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 le traitement successif passe par le moteur audio sur les données de la mémoire tampon du point de terminaison. |
|
IAudioClient ::GetMixFormat La méthode GetMixFormat récupère le format de flux utilisé par le moteur audio 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 pour le 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 l’appareil 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
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau | Applications UWP] |
| serveur minimum pris en charge | Windows Server 2008 [applications de bureau | Applications UWP] |
| plateforme cible | Windows |
| d’en-tête | audioclient.h |