Share via

Структура WAVEOUTCAPSA (mmeapi.h)

  • Статья

Структура WAVEOUTCAPS описывает возможности устройства вывода waveform-audio.

Синтаксис

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]

Название продукта в строке с пустым завершением.

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

Число, указывающее, поддерживает ли устройство моно(1) или стерео (2) выход.

wReserved1

dwSupport

Необязательные функции, поддерживаемые устройством. Определяются следующие значения:

Flag Описание
WAVECAPS_LRVOLUME Поддерживает отдельный левый и правый регулятор громкости.
WAVECAPS_PITCH Поддерживает управление шагом.
WAVECAPS_PLAYBACKRATE Поддерживает управление скоростью воспроизведения.
WAVECAPS_SYNC Драйвер является синхронным и будет блокироваться при воспроизведении буфера.
WAVECAPS_VOLUME Поддерживает управление громкости.
WAVECAPS_SAMPLEACCURATE Возвращает точные для выборки сведения о положении.

Комментарии

Если устройство поддерживает изменение тома, для члена dwSupport будет установлен флаг WAVECAPS_VOLUME. Если устройство поддерживает отдельные изменения тома в левом и правом каналах, для этого элемента будут установлены флаги WAVECAPS_VOLUME и WAVECAPS_LRVOLUME.

Примечание

Заголовок mmeapi.h определяет WAVEOUTCAPS как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть mmeapi.h (включая Windows.h)

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

Waveform Audio

Структуры волновой формы