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 de l’appareil.

Exigences

Produit Version
sdk Windows Windows 7
Visual Studio 2008

 

Téléchargement de l’exemple

Cet exemple est disponible dans les emplacements suivants.

Emplacement Chemin/URL
Kit de développement logiciel (SDK) Windows \Program Files\Microsoft SDKs\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 passez à 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 le de débogage ou configuration de la solution Release, sélectionnez le menu build 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 SDK. Dans ce cas, l’exemple ne sera pas généré, sauf 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 l’application de démonstration avec succès, un fichier exécutable, EndpointVolumeChanger.exe, est généré. Pour l’exécuter, tapez EndpointVolumeChanger dans une fenêtre de commande suivie d’arguments obligatoires ou facultatifs. L’exemple suivant montre comment activer le paramètre de désactivation du son sur l’appareil de console par défaut.

EndpointVolumeChanger.exe -console -m

Le tableau suivant présente les arguments.

Argument Description
-? Affiche l’aide.
-h Affiche l’aide.
-+ Incrémente le niveau de volume sur l’appareil de point de terminaison audio d’une étape. .
-en haut 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.
-en bas 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 maître sur l’appareil de point de terminaison audio.
-consoler Utilisez l’appareil de console par défaut.
-communications Utilisez l’appareil de communication par défaut.
-multimédia Utilisez l’appareil multimédia par défaut.
-extrémité Utilisez l’identificateur de point de terminaison spécifié dans la valeur du 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 du 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 de sdk qui utilisent les API audio principales