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

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

  • Статья

Функция waveOutGetPitch извлекает текущий параметр шага для указанного устройства вывода waveform-audio.

Синтаксис

MMRESULT waveOutGetPitch(
  HWAVEOUT hwo,
  LPDWORD  pdwPitch
);

Параметры

hwo

Обработка устройства вывода waveform-audio.

pdwPitch

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

Множитель шага указывается как значение с фиксированной запятой. Слово высокого порядка переменной содержит целочисленную часть числа со знаком, а слово низкого порядка — дробную часть. Значение 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

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

Waveform Audio

Функции waveform