Поделиться через

Функция waveOutSetPlaybackRate (mmeapi.h)

  • Статья

Функция waveOutSetPlaybackRate задает скорость воспроизведения для указанного устройства вывода волновой формы и звука.

Синтаксис

MMRESULT waveOutSetPlaybackRate(
  HWAVEOUT hwo,
  DWORD    dwRate
);

Параметры

hwo

Дескриптор устройства вывода waveform-audio.

dwRate

Новый параметр скорости воспроизведения. Этот параметр представляет собой множитель, указывающий текущее изменение скорости воспроизведения по сравнению с исходным созданным параметром. Множитель скорости воспроизведения должен быть положительным значением.

Ставка указывается как значение с фиксированной запятой. Слово высокого порядка содержит целочисленную часть числа со знаком, а слово нижнего порядка — дробную часть. Значение 0x8000 в нижнем порядке представляет половину, а 0x4000 — четверть. Например, значение 0x00010000 задает множитель 1,0 (без изменения скорости воспроизведения), а значение 0x000F8000 задает множитель 15,5.

Возвращаемое значение

Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:

Код возврата Описание
MMSYSERR_INVALHANDLE
 Указан недопустимый дескриптор устройства.
MMSYSERR_NODRIVER
 Отсутствует драйвер устройства.
MMSYSERR_NOMEM
 Не удается выделить или заблокировать память.
MMSYSERR_NOTSUPPORTED
 Функция не поддерживается.

Комментарии

Изменение скорости воспроизведения не влияет на частоту дискретизации, но изменяет время воспроизведения. Не все устройства поддерживают изменение скорости воспроизведения. Чтобы определить, поддерживает ли устройство изменение скорости воспроизведения, используйте флаг WAVECAPS_PLAYBACKRATE для проверки члена dwSupport структуры WAVEOUTCAPS (заполненной функцией waveOutGetDevCaps ).

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mmeapi.h (включая Windows.h)
Библиотека Winmm.lib
DLL Winmm.dll

См. также раздел

Звуковой сигнал

Функции волнообразной формы