Timecaps

typedef struct {

UINT wPeriodMin;

UINT wPeriodMax;

} TIMECAPS;

Переменные

0. wPeriodMin — минимально допустимое разрешение.

1. wPeriodMax — максимально допустимое разрешение.

Примечание

Объект структуры TIMERCAPS содержит информацию о временном разрешении таймера.

Описание данной структуры содержится в файле заголовка mmsystem.h.

Wavefilter

typedef struct {

DWORD cbStruct;

DWORD dwFilterTag;

DWORD fdwFilter;

DWORD dwReserved[5];

} WAVEFILTER;

Переменные

0. cbStruct — размер структуры WAVEFILTER в байтах. Эта переменная должна быть инициализирована до первого обращения к объекту структуры WAVEFILTER.

1. dwFilterTag — тип используемого аудио фильтра. Идентификаторы фильтров зарегистрированы корпорацией Microsoft для различных алгоритмов фильтрации.

2. fdwFilter — флаги, используемые для фильтра, определённого в переменной dwFilterTag. Флаги, определяемые в данной переменной должны относится ко всем типам фильтров. В настоящее время ни один флаг не определён.

3. dwReserved — зарезервировано для использования системой. Значение данной переменной не должно проверяться или изменяться приложением.

Примечание

Объект структуры WAVEFILTER определяет фильтр для аудио информации. В данной структуре содержится только информация, общая для всех аудио фильтров. Если для работы фильтра требуется некоторая дополнительная информация, объект данной структуры включается первым членом в объект другой структуры, содержащей эту дополнительную информацию.

Описание данной структуры содержится в файле заголовка mmreg.h.

Waveformatex

typedef struct {

WORD wFormatTag;

WORD nChannels;

DWORD nSamplesPerSec;

DWORD nAvgBytesPerSec;

WORD nBlockAlign;

WORD wBitsPerSample;

WORD cbSize;

} WAVEFORMATEX;

Переменные

0. wFormatTag — идентификатор используемого аудио формата. Идентификаторы различных форматов компрессированных аудио данных зарегистрированы корпорацией Microsoft. Полный список идентификаторов аудио форматов содержится в файле заголовка MMREG.H.

1. nChannels — число используемых каналов вывода аудио информации. При монофоническом воспроизведении используется один канал, а при стереофоническом — два.

2. nSamplesPerSec — частота дискретизации в Герцах. Если в переменной wFormatTag содержится идентификатор WAVE_FORMAT_PCM, то стандартными значениями переменной nSamplesPerSec являются 8.0, 11.025, 22.05 и 44.1 КГц. Для форматов, не использующих импульсно-кодовую модуляцию, это значение вычисляется, исходя из спецификации разработчика соответствующего формата.

3. nAvgBytesPerSec — скорость передачи данных, выраженная в байтах в секунду, используемая при воспроизведении информации в данном формате. Если в переменной wFormatTag содержится идентификатор WAVE_FORMAT_PCM, то значение переменной nAvgBytesPerSec равняется произведению значений переменных nSamplesPerSec и nBlockAlign. Для форматов, не использующих импульсно-кодовую модуляцию, это значение вычисляется, исходя из спецификации разработчика соответствующего формата.

4. Значение переменной nAvgBytesPerSec используется программным обеспечением для определения размера буферов при записи и воспроизведении сигналов.

5. nBlockAlign — граница выравнивания блока в байтах. В этой переменной хранится минимальный размер фрагмента данных, используемый в данном режиме компрессии. Если в переменной wFormatTag содержится идентификатор WAVE_FORMAT_PCM, то значение переменной nBlockAlign равняется произведению значений переменных nChannels и wBitsPerSample делённому на 8 (количеству бит в байте). Для форматов, не использующих импульсно-кодовую модуляцию, это значение вычисляется, исходя из спецификации разработчика соответствующего формата.

6. Размер буфера используется программным обеспечением для записи и воспроизведения сигналов должен быть кратным значению переменной nBlockAlign. Запись и воспроизведение информации должны всегда начинаться с начала блока. Например, недопустимо начинать воспроизведение аудио информации, записанной в формате с импульсно-кодовой модуляцией, с середины отсчёта (то есть не с границы выравнивания блока).

7. wBitsPerSample — количество битов, используемых для кодирования одного отсчёта данных в формате, определённом в переменной wFormatTag. Если в переменной wFormatTag содержится идентификатор WAVE_FORMAT_PCM, то переменная wBitsPerSample может принимать только два значения: 8 и 16. Для форматов, не использующих импульсно-кодовую модуляцию, это значение вычисляется, исходя из спецификации разработчика соответствующего формата. В некоторых схемах компрессии данных значение переменной не может быть корректно определено, в этих случаях в данную переменную записывается нулевое значение.

8. cbSize — размер блока дополнительной информации, записываемой после объекта структуры WAVEFORMATEX, выраженный в байтах. Эта информация может использоваться форматами, не использующими импульсно-кодовую модуляцию, для хранения необходимой им информации. Если для заданного в переменной wFormatTag режима компрессии не требуется хранения дополнительной информации, в эту переменную заносится нулевое значение. В формате WAVE_FORMAT_PCM (и только в этом формате) значение данной переменной игнорируется.

Примечание

Объект структуры WAVEFORMATEX определяет формат используемой аудио информации. Эта структура содержит только та информация, которая характерна для всех форматов компрессии данных. При необходимости хранения дополнительной информации к данной структуре может быть добавлен дополнительный блок данных, размер которого указан в последнем элементе данной структуры.

Примером формата, использующего блок с дополнительной информацией, является разработанный корпорацией Microsoft формат адаптивной дифференциальной кодовой модуляции (MS-ADPCM). Обычно значением переменной cbSize для данного формата является 32. Данный формат записывает в дополнительный блок данных значения пары коэффициентов, используемых для кодирования и декодирования данных.

Описание данной структуры содержится в файле заголовка mmreg.h