Структура WAVEOUTCAPSA (mmeapi.h)
Структура WAVEOUTCAPS описывает возможности устройства вывода волнового звука.
Синтаксис
typedef struct tagWAVEOUTCAPSA {
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
CHAR szPname[MAXPNAMELEN];
DWORD dwFormats;
WORD wChannels;
WORD wReserved1;
DWORD dwSupport;
} WAVEOUTCAPSA, *PWAVEOUTCAPSA, *NPWAVEOUTCAPSA, *LPWAVEOUTCAPSA;
Члены
wMid
Идентификатор производителя драйвера устройства для устройства. Идентификаторы изготовителя определяются в изготовителя и идентификаторов продуктов.
wPid
Идентификатор продукта для устройства. Идентификаторы продуктов определяются в изготовителя и идентификаторов продуктов.
vDriverVersion
Номер версии драйвера устройства для устройства. Байт высокого порядка — это основной номер версии, а байт низкого порядка — это дополнительный номер версии.
szPname[MAXPNAMELEN]
Имя продукта в строке, завершаемой значением NULL.
dwFormats
Поддерживаемые стандартные форматы. Может быть сочетанием следующих значений:
| Формат | Описание |
|---|---|
| WAVE_FORMAT_1M08 | 11,025 кГц, моно, 8-разрядная |
| WAVE_FORMAT_1M16 | 11,025 кГц, моно, 16-разрядная |
| WAVE_FORMAT_1S08 | 11,025 кГц, стерео, 8-разрядная |
| WAVE_FORMAT_1S16 | 11,025 кГц, стерео, 16-разрядная |
| WAVE_FORMAT_2M08 | 22,05 кГц, моно, 8-разрядная |
| WAVE_FORMAT_2M16 | 22,05 кГц, моно, 16-разрядная |
| WAVE_FORMAT_2S08 | 22,05 кГц, стерео, 8-разрядная |
| WAVE_FORMAT_2S16 | 22,05 кГц, стерео, 16-разрядная |
| WAVE_FORMAT_4M08 | 44,1 кГц, моно, 8-разрядная |
| WAVE_FORMAT_4M16 | 44,1 кГц, моно, 16-разрядная |
| WAVE_FORMAT_4S08 | 44,1 кГц, стерео, 8-разрядная |
| WAVE_FORMAT_4S16 | 44,1 кГц, стерео, 16-разрядная |
| WAVE_FORMAT_96M08 | 96 кГц, моно, 8-разрядная |
| WAVE_FORMAT_96M16 | 96 кГц, моно, 16-разрядная |
| WAVE_FORMAT_96S08 | 96 кГц, стерео, 8-разрядная |
| WAVE_FORMAT_96S16 | 96 кГц, стерео, 16-разрядная |
wChannels
Число, указывающее, поддерживает ли устройство выходные данные mono (1) или стерео (2).
wReserved1
dwSupport
Необязательные функции, поддерживаемые устройством. Определены следующие значения:
| Флаг | Описание |
|---|---|
| WAVECAPS_LRVOLUME | Поддерживает отдельный левый и правый элемент управления томом. |
| WAVECAPS_PITCH | Поддерживает управление полем. |
| WAVECAPS_PLAYBACKRATE | Поддерживает управление скоростью воспроизведения. |
| WAVECAPS_SYNC | Драйвер синхронно и блокируется при воспроизведении буфера. |
| WAVECAPS_VOLUME | Поддерживает управление томами. |
| WAVECAPS_SAMPLEACCURATE | Возвращает данные о точном расположении образца. |
Замечания
Если устройство поддерживает изменение тома, флаг WAVECAPS_VOLUME будет установлен для элемента dwSupport. Если устройство поддерживает отдельные изменения тома в левых и правых каналах, для этого элемента будут заданы WAVECAPS_VOLUME и флаги WAVECAPS_LRVOLUME.
Заметка
Заголовок mmeapi.h определяет WAVEOUTCAPS как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| заголовка | mmeapi.h (включая Windows.h) |
См. также
звуковой waveform