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

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

  • Статья

Функция waveOutSetPitch задает шаг для указанного устройства вывода звуковой волны.

Синтаксис

MMRESULT waveOutSetPitch(
  HWAVEOUT hwo,
  DWORD    dwPitch
);

Параметры

hwo

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

dwPitch

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

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

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

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

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

Комментарии

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

Требования

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

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

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

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