EndpointVolume

  • Artículo

En esta aplicación de ejemplo se usan las API de audio principal para cambiar el volumen del dispositivo, según lo especificado por el usuario.

En este tema se incluyen las siguientes secciones.

Descripción

En este ejemplo se muestran las siguientes características.

  • API MMDevice para la enumeración y selección de dispositivos multimedia.
  • EndpointVolume API para controlar los niveles de volumen del punto de conexión del dispositivo.

Requisitos

Producto Versión
Windows SDK Windows 7
Visual Studio 2008

 

Descarga del ejemplo

Este ejemplo está disponible en las siguientes ubicaciones.

Location Ruta de acceso y dirección URL
Windows SDK \Archivos de programa\Microsoft SDKs\Windows\v7.0\Samples\Multimedia\Audio\EndpointVolume\...

 

Generar el ejemplo

Para compilar el ejemplo x, siga estos pasos:

Para compilar el ejemplo EndpointVolumeChanger, siga estos pasos:

  1. Abra el shell de CMD para Windows SDK y cambie al directorio de ejemplo EndpointVolume.
  2. Ejecute el comando start EndpointVolumeChanger.sln en el directorio EndpointVolume para abrir el proyecto EndpointVolumeChanger en la ventana de Visual Studio.
  3. En la ventana, seleccione la configuración de la solución Depurar o Liberar , seleccione el menú Compilar en la barra de menús y seleccione la opción Compilar . Si no abre Visual Studio desde el shell de CMD para el SDK, Visual Studio no tendrá acceso al entorno de compilación del SDK. En ese caso, el ejemplo no se compilará a menos que establezca explícitamente la variable de entorno MSSdk, que se usa en el archivo del proyecto, WASAPIEndpointVolume.vcproj.

Ejecutar el ejemplo

Si compila correctamente la aplicación de demostración, se genera un archivo ejecutable, EndpointVolumeChanger.exe. Para ejecutarlo, escriba EndpointVolumeChanger una ventana de comandos seguida de argumentos obligatorios o opcionales. En el ejemplo siguiente se muestra cómo alternar la configuración de exclusión en el dispositivo de consola predeterminado.

EndpointVolumeChanger.exe -console -m

En la tabla siguiente se muestran los argumentos.

Argumento Descripción
-? Muestra ayuda.
-H Muestra ayuda.
-+ Incrementa el nivel de volumen en el dispositivo de punto de conexión de audio en un paso. .
-up Incrementa el nivel de volumen en el dispositivo de punto de conexión de audio en un paso.
-- Disminuye el nivel de volumen en el dispositivo de punto de conexión de audio en un paso.
-down Disminuye el nivel de volumen en el dispositivo de punto de conexión de audio en un paso.
-v Establece el nivel de volumen maestro en el dispositivo de punto de conexión de audio.
-Consola Use el dispositivo de consola predeterminado.
-Comunicaciones Use el dispositivo de comunicación predeterminado.
-Multimedia Use el dispositivo multimedia predeterminado.
-Extremo Use el identificador de punto de conexión especificado en el valor del modificador.

 

Si la aplicación se ejecuta sin argumentos, enumera los dispositivos disponibles y solicita al usuario que seleccione un dispositivo. Una vez que el usuario especifica el dispositivo, la aplicación muestra la configuración de volumen actual para el punto de conexión. El volumen se puede controlar mediante los modificadores descritos en la tabla anterior.

Para obtener más información sobre cómo controlar los niveles de volumen de los dispositivos de punto de conexión de audio, consulte EndpointVolume API.

Ejemplos del SDK que usan las API de audio principal