Share via

Función waveOutGetPlaybackRate (mmeapi.h)

  • Artículo

La función waveOutGetPlaybackRate recupera la velocidad de reproducción actual del dispositivo de salida waveform-audio especificado.

Sintaxis

MMRESULT waveOutGetPlaybackRate(
  HWAVEOUT hwo,
  LPDWORD  pdwRate
);

Parámetros

hwo

Controle el dispositivo de salida de forma de onda y audio.

pdwRate

Puntero a una variable que se va a rellenar con la velocidad de reproducción actual. La configuración de velocidad de reproducción es un multiplicador que indica el cambio actual en la velocidad de reproducción del valor original creado. El multiplicador de velocidad de reproducción debe ser un valor positivo.

La velocidad se especifica como un valor de punto fijo. La palabra de orden alto de la variable 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 realiza correctamente o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto Descripción
MMSYSERR_INVALHANDLE
 El identificador de dispositivo especificado no es válido.
MMSYSERR_NODRIVER
 No hay ningún controlador de dispositivo presente.
MMSYSERR_NOMEM
 No se puede asignar o bloquear la memoria.
MMSYSERR_NOTSUPPORTED
 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 de 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

Requisito Value
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 (incluya Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll

Consulte también

Audio de forma de onda

Funciones de forma de onda