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

Статья
08/24/2023

Функция 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

Share via