Partager via

EndpointVolume

  • Article

Cet exemple d’application utilise les API Core Audio pour modifier le volume de l’appareil, comme spécifié par l’utilisateur.

Cette rubrique contient les sections suivantes.

Description

Cet exemple illustre les fonctionnalités suivantes.

  • API MMDevice pour l’énumération et la sélection d’appareils multimédias.
  • API EndpointVolume pour contrôler les niveaux de volume du point de terminaison d’appareil.

Spécifications

Produit Version
SDK Windows Windows 7
Visual Studio 2008

 

Téléchargement de l’exemple

Cet exemple est disponible aux emplacements suivants.

Emplacement Chemin/URL
Kit de développement logiciel (SDK) Windows \Program Files\Microsoft SDK\Windows\v7.0\Samples\Multimedia\Audio\EndpointVolume\...

 

Génération de l'exemple

Pour générer l’exemple x, procédez comme suit :

Pour générer l’exemple EndpointVolumeChanger, procédez comme suit :

  1. Ouvrez l’interpréteur de commandes CMD pour le KIT de développement logiciel (SDK) Windows et accédez à l’exemple de répertoire EndpointVolume.
  2. Exécutez la commande start EndpointVolumeChanger.sln dans le répertoire EndpointVolume pour ouvrir le projet EndpointVolumeChanger dans la fenêtre Visual Studio.
  3. Dans la fenêtre, sélectionnez la configuration de la solution Déboguer ou Libérer , sélectionnez le menu Générer dans la barre de menus, puis sélectionnez l’option Générer . Si vous n’ouvrez pas Visual Studio à partir de l’interpréteur de commandes CMD pour le Kit de développement logiciel (SDK), Visual Studio n’aura pas accès à l’environnement de génération du KIT de développement logiciel (SDK). Dans ce cas, l’exemple ne sera généré que si vous définissez explicitement la variable d’environnement MSSdk, qui est utilisée dans le fichier projet, WASAPIEndpointVolume.vcproj.

Exécution de l'exemple

Si vous générez correctement l’application de démonstration, un fichier exécutable, EndpointVolumeChanger.exe, est généré. Pour l’exécuter, tapez EndpointVolumeChanger dans une fenêtre de commande suivie des arguments obligatoires ou facultatifs. L’exemple suivant montre comment désactiver le paramètre de désactivation sur l’appareil console par défaut.

EndpointVolumeChanger.exe -console -m

Le tableau suivant présente les arguments.

Argument Description
-? Affiche de l’aide.
-H Affiche de l’aide.
-+ Incrémente le niveau de volume sur l’appareil de point de terminaison audio d’une étape. .
-up Incrémente le niveau de volume sur l’appareil de point de terminaison audio d’une étape.
-- Décrémente le niveau de volume sur l’appareil de point de terminaison audio d’une étape.
-down Décrémente le niveau de volume sur l’appareil de point de terminaison audio d’une étape.
-v Définit le niveau de volume master sur l’appareil de point de terminaison audio.
-Console Utilisez l’appareil console par défaut.
-Communications Utilisez le périphérique de communication par défaut.
-Multimédia Utilisez l’appareil multimédia par défaut.
-Terminaison Utilisez l’identificateur de point de terminaison spécifié dans la valeur de commutateur.

 

Si l’application est exécutée sans arguments, elle énumère les appareils disponibles et invite l’utilisateur à sélectionner un appareil. Une fois que l’utilisateur a spécifié l’appareil, l’application affiche les paramètres de volume actuels pour le point de terminaison. Le volume peut être contrôlé à l’aide des commutateurs décrits dans le tableau précédent.

Pour plus d’informations sur le contrôle des niveaux de volume des appareils de point de terminaison audio, consultez API EndpointVolume.

Exemples sdk qui utilisent les API audio de base