RenderSharedTimerDriven

  • Artículo

Esta aplicación de ejemplo usa core Audio API para representar datos de audio en un dispositivo de salida especificado por el usuario. En este ejemplo se muestra el almacenamiento en búfer controlado por el temporizador para un cliente de representación en modo compartido. En el caso de una secuencia en modo compartido, el cliente comparte el búfer del punto de conexión con el motor de audio.

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.
  • WASAPI para las operaciones de administración de flujos.

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\RenderSharedTimerDriven\...

 

Generar el ejemplo

Para compilar el ejemplo RenderSharedTimerDriven, siga estos pasos:

  1. Abra el shell de CMD para Windows SDK y cambie al directorio de ejemplo RenderSharedTimerDriven.
  2. Ejecute el comando start WASAPIRenderSharedTimerDriven.sln en el directorio RenderSharedTimerDriven para abrir el proyecto WASAPIRenderSharedTimerDriven 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, WASAPIRenderSharedTimerDriven.vcproj.

Ejecutar el ejemplo

Si compila correctamente la aplicación de demostración, se genera un archivo ejecutable, WASAPIRenderSharedTimerDriven.exe. Para ejecutarlo, escriba WASAPIRenderSharedTimerDriven una ventana de comandos seguida de argumentos obligatorios o opcionales. En el ejemplo siguiente se muestra cómo ejecutar el ejemplo especificando la duración de reproducción en el dispositivo multimedia predeterminado.

WASAPIRenderSharedTimerDriven.exe -d 20 -multimedia

En la tabla siguiente se muestran los argumentos.

Argumento Descripción
-? Muestra ayuda.
-H Muestra ayuda.
-f Frecuencia de onda de seno en Hz.
-l Latencia de representación de audio en milisegundos.
-d Duración de onda seno en segundos.
-M Deshabilita el uso de MMCSS.
-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 para la sesión de representación. Una vez que el usuario especifica un dispositivo, la aplicación representa una onda de seno a 440 Hz durante 10 segundos. Estos valores se pueden modificar especificando los valores de modificador -f y -d.

RenderSharedTimerDriven muestra el almacenamiento en búfer controlado por el temporizador. En este modo, el cliente debe esperar un período de tiempo (la mitad de la latencia, especificada por el valor del modificador -d, en milisegundos). Cuando el cliente se reactiva, a mitad del período de procesamiento, extrae el siguiente conjunto de muestras del motor. Antes de que cada procesamiento pase el bucle de almacenamiento en búfer, el cliente debe averiguar la cantidad de datos que se van a representar para que los datos no superen el búfer.

Los datos de audio que se reproducirán en el dispositivo especificado se pueden procesar habilitando el almacenamiento en búfer controlado por eventos. Este modo se muestra en el ejemplo RenderSharedEventDriven .

Para obtener más información sobre cómo representar una secuencia, consulte Representación de una secuencia.

Ejemplos del SDK que usan las API de audio principal