Función waveOutSetPlaybackRate (mmeapi.h)
La función waveOutSetPlaybackRate establece la velocidad de reproducción del dispositivo de salida de forma de onda especificado.
Sintaxis
MMRESULT waveOutSetPlaybackRate(
HWAVEOUT hwo,
DWORD dwRate
);
Parámetros
hwo
Controla el dispositivo de salida de audio de forma de onda.
dwRate
Nueva configuración de velocidad de reproducción. Esta configuración es un multiplicador que indica el cambio actual en la velocidad de reproducción de la configuración original de creación. El multiplicador de velocidad de reproducción debe ser un valor positivo.
La tasa se especifica como un valor de punto fijo. La palabra de orden superior contiene la parte entera con signo del número y la palabra de orden bajo contiene la parte fraccionaria. Un valor de 0x8000 en la palabra de orden bajo representa una mitad y 0x4000 representa un cuarto. Por ejemplo, el valor 0x00010000 especifica un multiplicador de 1,0 (sin cambio de velocidad de reproducción) y un valor de 0x000F8000 especifica un multiplicador de 15,5.
Valor devuelto
Devuelve MMSYSERR_NOERROR si se ejecuta correctamente o si se produce un error. Entre los posibles valores de error se incluyen los siguientes.
| Código devuelto | Descripción |
|---|---|
|
El identificador de dispositivo especificado no es válido. |
|
No hay ningún controlador de dispositivo presente. |
|
No se puede asignar o bloquear la memoria. |
|
No se admite la función. |
Comentarios
Cambiar la velocidad de reproducción no cambia la frecuencia de muestreo, pero cambia el tiempo de reproducción. No todos los dispositivos admiten cambios de velocidad de reproducción. Para determinar si un dispositivo admite cambios en la velocidad de reproducción, use la marca WAVECAPS_PLAYBACKRATE para probar el miembro dwSupport de la estructura WAVEOUTCAPS (rellenado por la función waveOutGetDevCaps ).
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mmeapi.h (incluye Windows.h) |
| Library | Winmm.lib |
| Archivo DLL | Winmm.dll |