Mci_setaudio

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_SETAUDIO, DWORD dwFlags, (DWORD) (LPMCI_GENERIC_PARMS) lpSetAudio);

Возвращаемое значение

В случае успешного завершения работы возвращает нулевое значение и значение ошибки в противном случае.

Аргументы

0. wDeviceID — идентификатор устройства MCI, которому посылается данное командное сообщение.

1. dwFlags — Флаги сообщения MCI_NOTIFY, MCI_WAIT или для видеомагнитофона и устройства вывода видео информации MCI_TEST. Кроме того, для сообщения MCI_SET определены следующие значения:

2. Данные флаги могут использоваться устройствами типа digitalvideo:

• MCI_DGV_SETAUDIO_ALG — в переменной lpstrAlgorithm объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится указатель на буфер, содержащий имя алгоритма компрессии аудио информации. Этот алгоритм компрессии используется вызываемыми впоследствии командами MCI_RESERVE и MCI_RECORD. Данный алгоритм не зависит от устройства. Если указанный алгоритм несовместим с текущим форматом файла, то формат изменяется на формат, определённый для данного алгоритма по умолчанию.

• MCI_DGV_SETAUDIO_CLOCKTIME — при установке флага MCI_DGV_SETAUDIO_OVER время задаётся в миллисекундах и является абсолютным временем, не связанным со временем воспроизведения данного фрагмента аудио информации.

• MCI_DGV_SETAUDIO_INPUT — изменяет состояние флагов высоких и низких звуковых частот, а также флага уровня воспроизведения таким образом, что новые установки влияют на входной сигнал и записываемую информацию. Если это возможно, этот флаг устанавливается по умолчанию в режиме контроля входного сигнала.

• MCI_DGV_SETAUDIO_ITEM — в переменной dwItem объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится одна из аудио констант, определяющих устанавливаемое значение. Определены следующие константы:

MCI_DGV_SETAUDIO_AVGBYTESPERSEC — в переменной dwValue объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится среднее число байт, предаваемых в секунду при воспроизведении или записи аудио информации в форматах ИКМ или АДИКМ. Эти форматы используются для сохранения информации в файле.

MCI_DGV_SETAUDIO_BASS — в переменной dwValue объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится уровень воспроизведения низкочастотной составляющей аудио сигнала.

MCI_DGV_SETAUDIO_BITSPERSAMPLE — в переменной dwValue объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится количество бит, используемое для хранения одного отсчёта аудио информации при использовании формата ИКМ. Этот формат используется для сохранения информации в файле.

MCI_DGV_SETAUDIO_BLOCKALIGN — в переменной dwValue объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится размер блока информации, используемого в данном формате. Значение данной величины используется при выравнивании по границе блока.

MCI_DGV_SETAUDIO_SAMPLESPERSEC — в переменной dwValue объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится частота дискретизации. Данная величина используется в форматах ИКМ и АДИКМ. Эти форматы используются для сохранения информации в файле.

MCI_DGV_SETAUDIO_SOURCE SAMPLESPERSEC — в переменной dwValue объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится константа, определяющая источник аудио информации. Определены следующие значения констант:

MCI_DGV_SETAUDIO_SOURCE_AVERAGE — производится микширование сигналов левого и правого аудио каналов.

MCI_DGV_SETAUDIO_SOURCE_LEFT — информация поступает из левого аудио канала.

MCI_DGV_SETAUDIO_SOURCE_RIGHT — информация поступает из правого аудио канала.

MCI_DGV_SETAUDIO_SOURCE_STEREO — используется стерео режим.

MCI_DGV_SETAUDIO_STREAM — переменная dwValue объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, определяет аудио поток. Целочисленная величина определяет номер выводимого аудио потока. Если номер аудио канала не задан, воспроизводится первый физический поток.

MCI_DGV_SETAUDIO_TREBLE — в переменной dwValue объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится уровень воспроизведения высокочастотной составляющей аудио сигнала.

• MCI_DGV_SETAUDIO_VOLUME — в переменной dwValue объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится уровень воспроизведения в обоих аудио каналах. Если для левого и правого каналов установлены различные уровни воспроизведения, то отношение уровней воспроизведения в каналах при этом сохраняется.

• MCI_DGV_SETAUDIO_LEFT — при установленном флаге MCI_SET_ON разрешает использование левого аудио канала. При сброшенном флаге MCI_SET_ON запрещает использование левого аудио канала. При установленных флагах MCI_DGV_SETAUDIO_VALUE и MCI_DGV_SETAUDIO_VOLUME устанавливает уровень воспроизведения левого аудио канала. При установленном флаге MCI_DGV_SETAUDIO_SOURCE определяет левый канал в качестве источника записываемой аудио информации.

• MCI_DGV_SETAUDIO_OVER — в переменной dwOver объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится интервал переключения. Эта величина определяет (в единицах текущего формата времени) временной отрезок, который займёт переключение данного параметра. Если этот флаг не установлен, все изменения происходят мгновенно.

• MCI_DGV_SETAUDIO_QUALITY — в переменной lpstrQuality объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится указатель на буфер, определяющий качество аудио информации. Текстовая строка, содержащаяся в данном буфере, содержит параметры алгоритма сжатия аудио информации.

Флаг MCI_DGV_SETAUDIO_ALG может использоваться для задания дескриптора качества указанного алгоритма. Если этот флаг сброшен, используется текущий алгоритм.

Имена алгоритмов и дескрипторов качества зависят от конкретного устройства. В документации по каждому устройству содержится описание имеющихся алгоритмов и дескрипторов. Для определения дополнительных имён дескрипторов используется команда MCI_QUALITY.

• MCI_DGV_SETAUDIO_RECORD — определяет режим записи аудио информации. При установленном флаге MCI_SET_ON производит запись аудио информации с устройства. При сброшенном флаге MCI_SET_ON вводимая аудио информация теряется. По умолчанию поступающая с устройства аудио информация записывается.

• MCI_DGV_SETAUDIO_RIGHT — при установленном флаге MCI_SET_ON разрешает использование правого аудио канала. При сброшенном флаге MCI_SET_ON запрещает использование правого аудио канала. При установленных флагах MCI_DGV_SETAUDIO_VALUE и MCI_DGV_SETAUDIO_VOLUME устанавливает уровень воспроизведения правого аудио канала.

• MCI_DGV_SETAUDIO_VALUE — в переменной dwValue объекта структуры MCI_DGV_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится некоторая величина. Интерпретация данной величины зависит от состояния флага MCI_DGV_SETAUDIO_ITEM.

• MCI_SET_OFF — отключает указанный аудио канал.

• MCI_SET_ON — разрешает использование указанного аудио канала.

• MCI_SETAUDIO_OUTPUT — изменяет состояние флагов высоких и низких звуковых частот, а также флага уровня воспроизведения таким образом, что новые установки влияют на выходной. Если это возможно, этот флаг устанавливается по умолчанию в режиме контроля выходного сигнала.

0. Данные флаги могут использоваться устройствами типа vcr:

• MCI_VCR_SETAUDIO_RECORD — включает и отключает режим записи аудио информации. Используется совместно со следующими флагами:

MCI_SET_ON — включает режим записи аудио информации.

MCI_SET_OFF — отключает режим записи аудио информации. Перед отключением режима записи аудио информации иногда необходимо отключить групповой режим записи (сбросить флаг MCI_VCR_SET_ASSEMBLE_RECORD в команде MCI_SET).

MCI_TRACK — переменная dwTrack объекта структуры MCI_VCR_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, определяет дорожку к которому относится данная команда.

• MCI_VCR_SETAUDIO_SOURCE — устанавливает источник аудио информации. Этот флаг должен устанавливаться одновременно с флагом MCI_VCR_SETAUDIO_TO.

• MCI_VCR_SETAUDIO_MONITOR — устанавливает режим контроля источника аудио информации. Этот флаг должен устанавливаться одновременно с флагом MCI_VCR_SETAUDIO_TO.

• MCI_VCR_SETAUDIO_TO — в переменной dwTo объекта структуры MCI_VCR_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится константа, определяющая тип источника аудио информации. Определены следующие константы:

MCI_VCR_SRC_TYPE_TUNER — тюнер.

MCI_VCR_SRC_TYPE_LINE — линия.

MCI_VCR_SRC_TYPE_AUX — вспомогательное устройство.

MCI_VCR_SRC_TYPE_GENERIC — общий тип устройства.

MCI_VCR_SRC_TYPE_MUTE — отсутствие сигнала. Этот тип может использоваться только совместно с флагом MCI_VCR_SETAUDIO_SOURCE.

MCI_VCR_SRC_TYPE_OUTPUT — информация записывается с выхода.

• MCI_VCR_SETAUDIO_NUMBER — в переменной dwNumber объекта структуры MCI_VCR_SETAUDIO_PARMS, на который указывает аргумент lpSetAudio, содержится идентификатор используемого источника аудио информации (одна из констант, используемых в переменной dwTo).

0. lpSetAudio — указатель на объект структуры MCI_GENERIC_PARMS. (Устройства, имеющие расширенный набор команд, используют вместо этой структуры собственные структуры.)

Примечание

Команда MCI_SETAUDIO устанавливает режимы записи и воспроизведения аудио информации. Эту команду можно посылать устройству воспроизведения и записи видео информации и видеомагнитофону.

При работе устройством воспроизведения и записи видео информации в переменной lpSetAudio передаётся указатель на объект структуры MCI_DGV_SETAUDIO_PARMS, а при работе с видеомагнитофоном в этой переменной передаётся указатель на объект структуры MCI_VCR_SETAUDIO_PARMS.

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