EndpointVolume
Cet exemple d’application utilise les API audio de base pour modifier le volume de l’appareil, comme spécifié par l’utilisateur.
Cette rubrique contient les sections suivantes.
- Description
- Configuration requise
- Téléchargement de l’exemple
- Génération de l'exemple
- Exécution de l’exemple
- Rubriques connexes
Description
Cet exemple illustre les fonctionnalités suivantes.
- API MMDevice pour l’énumération et la sélection des appareils multimédias.
- API EndpointVolume pour contrôler les niveaux de volume du point de terminaison de l’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 d’accès/URL |
|---|---|
| Kit de développement logiciel (SDK) Windows | \Program Files \ Microsoft sdk \ Windows \ v 7.0 \ samples \ \ Audio Multimedia \ 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 :
- ouvrez l’interpréteur de commandes pour le SDK Windows et accédez au répertoire d’exemple EndpointVolume.
- exécutez la commande
start EndpointVolumeChanger.slndans le répertoire EndpointVolume pour ouvrir le projet EndpointVolumeChanger dans la fenêtre Visual Studio. - À partir de la fenêtre, sélectionnez la configuration de la solution Debug ou Release , 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 du shell 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 n’est 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 basculer le paramètre muet sur l’appareil de la console par défaut.
EndpointVolumeChanger.exe -console -m
Le tableau suivant indique 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. . |
| vers le 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. |
| -vers le | 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. |
| -Console | Utilisez l’appareil de la console par défaut. |
| -Communications | Utilisez l’appareil de communication par défaut. |
| -multimédia | Utilisez l’appareil multimédia par défaut. |
| -point de 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 périphériques disponibles et invite l’utilisateur à sélectionner un appareil. Une fois que l’utilisateur spécifie l’appareil, l’application affiche les paramètres actuels du volume 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.