команда MCI_SETAUDIO

Статья
06/13/2023

Команда MCI_SETAUDIO задает значения, связанные с воспроизведением и записью звука. Цифровые видеоустройства и виртуальные машины распознают эту команду.

Чтобы отправить эту команду, вызовите функцию mciSendCommand со следующими параметрами.

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

Параметры

wDeviceID: Идентификатор устройства MCI, которое получает сообщение команды.
Dwflags: MCI_NOTIFY, MCI_WAIT или MCI_TEST. Сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.
lpSetAudio: Указатель на структуру MCI_GENERIC_PARMS . (Устройства с расширенными наборами команд могут заменить эту структуру структурой для конкретного устройства.)

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

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

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

MCI_DGV_SETAUDIO_CLOCKTIME

Указанное время — в миллисекундах и абсолютное время при использовании с MCI_DGV_SETAUDIO_OVER. (Это время не в ногу с воспроизведением рабочей области.)

MCI_DGV_SETAUDIO_INPUT

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

MCI_DGV_SETAUDIO_ITEM

Аудиоконстанта указывается в элементе dwItem структуры, определяемой lpSetAudio. Константа идентифицирует устанавливаемое значение. Определяются следующие константы:

MCI_DGV_SETAUDIO_AVGBYTESPERSEC

Среднее число байтов указывается в элементе dwValue структуры, определяемой lpSetAudio. Это значение задает среднее число байтов в секунду для воспроизведения или записи в форматах PCM (пульсовая модуляция кода) и ADPCM (адаптивная дифференциальная пульсовая модуляция). Файл сохраняется в этом формате.

MCI_DGV_SETAUDIO_BASS

Уровень низкой частоты звука указывается в качестве фактора в элементе dwValue структуры, определяемой lpSetAudio.

MCI_DGV_SETAUDIO_BITSPERSAMPLE

Число битов на выборку указывается в элементе dwValue структуры, определяемой lpSetAudio. Это значение задает количество битов на каждую выборку, воспроизводимую или записанную в формате PCM. Файл сохраняется в этом формате.

MCI_DGV_SETAUDIO_BLOCKALIGN

Выравнивание блока данных указывается в элементе dwValue структуры, определяемой lpSetAudio. Это значение задает выравнивание блоков данных относительно начала входных данных формы волны.

MCI_DGV_SETAUDIO_SAMPLESPERSEC

Частота выборки указывается в элементе dwValue структуры, определяемой lpSetAudio. Это значение задает частоту дискретизации для воспроизведения и записи с помощью алгоритмов PCM и ADPCM. Файл сохраняется в этом формате.

MCI_DGV_SETAUDIO_SOURCE

Константа, указывающая источник аудиовхода, включается в элемент dwValue структуры, определяемой 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 структуры, определяемой lpSetAudio. Целочисленное значение указывает аудиопоток, воспроизводимый из рабочей области. Если поток не указан, воспроизводится первый физически чередуемый аудиопоток.

MCI_DGV_SETAUDIO_TREBLE

Высокочастотный уровень звука указывается в качестве фактора в элементе dwValue структуры, определяемой lpSetAudio.

MCI_DGV_SETAUDIO_VOLUME

Уровень звука для одного или обоих аудиоканалов указывается в качестве фактора в элементе dwValue структуры, определяемой lpSetAudio. Если для левого и правого томов заданы разные значения, то соотношение левого и правого томов приблизительно не изменяется.

MCI_DGV_SETAUDIO_LEFT

Включает левый аудиоканал при использовании с MCI_SET_ON. Отключает левый аудиоканал при использовании с MCI_SET_OFF. Если этот флаг используется с сочетанием MCI_DGV_SETAUDIO_VALUE и MCI_DGV_SETAUDIO_VOLUME, он задает громкость левого звукового канала. Если этот флаг используется с MCI_DGV_SETAUDIO_SOURCE, он указывает левый аудиоканал в качестве источника для дигитайзера входных аудиоданных.

MCI_DGV_SETAUDIO_OVER

Параметр длины перехода включается в элемент dwOver структуры, определяемой lpSetAudio. Значение длины указывает, сколько времени (в единицах текущего формата времени) потребуется для изменения, использующего фактор. Если этот флаг не используется, изменения происходят немедленно.

MCI_DGV_SETAUDIO_QUALITY

Элемент lpstrQuality структуры, определяемой lpSetAudio , содержит адрес буфера, определяющий качество звука. Текстовая строка в буфере определяет характеристики алгоритма сжатия звука.

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

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

MCI_DGV_SETAUDIO_RECORD

Указывает, включает ли запись или исключает звуковые данные. В сочетании с MCI_SET_ON записываются звуковые данные. В сочетании с MCI_SET_OFF аудиоданные исключаются. Значение по умолчанию включает звуковые данные.

MCI_DGV_SETAUDIO_RIGHT

Включает правильный звуковой канал при использовании с MCI_SET_ON. Отключает правильный звуковой канал при использовании с MCI_SET_OFF. Если этот флаг используется с сочетанием MCI_DGV_SETAUDIO_VALUE и MCI_DGV_SETAUDIO_VOLUME, он задает громкость правильного звукового канала.

MCI_DGV_SETAUDIO_VALUE

Значение указывается в элементе dwValue структуры, определяемой lpSetAudio. Значение значения определяется константой, определенной для флага MCI_DGV_SETAUDIO_ITEM.

MCI_SET_OFF

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

MCI_SET_ON

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

MCI_SETAUDIO_OUTPUT

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

Для цифровых видеоустройств параметр lpSetAudio указывает на структуру MCI_DGV_SETAUDIO_PARMS .

Следующие дополнительные флаги используются с типом устройства vcr :

MCI_VCR_SETAUDIO_RECORD

Устанавливает для записи звука значение включено или выключено, которое используется в сочетании с одним из следующих флагов:

MCI_SET_ON

Аудиозапись включена.

MCI_SET_OFF

Аудиозапись отключена. Перед отключением записи звука может потребоваться сначала отключить запись сборки (с помощью команды MCI_SET с флагом MCI_VCR_SET_ASSEMBLE_RECORD значением off.

MCI_TRACK

Элемент dwTrack структуры, определяемой lpSetAudio , указывает, на какой трек влияет команда.

MCI_VCR_SETAUDIO_SOURCE

Задает источник звука. Этот флаг должен использоваться с флагом MCI_VCR_SETAUDIO_TO.

MCI_VCR_SETAUDIO_MONITOR

Задает монитор источника звука. Этот флаг должен использоваться с флагом MCI_VCR_SETAUDIO_TO.

MCI_VCR_SETAUDIO_TO

Элемент dwTo структуры, определяемой lpSetAudio , содержит константу, описывающую тип входных или отслеживаемых входных данных. Он должен быть одним из следующих:

MCI_VCR_SRC_TYPE_TUNER

Тип — тюнер.

MCI_VCR_SRC_TYPE_LINE

Тип — 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 структуры, определяемой lpSetAudio, содержит входные звуковые данные (типа, указанного в элементе dwTo) для использования.

Для устройств VCR параметр lpSetAudio указывает на структуру MCI_VCR_SETAUDIO_PARMS .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Mmsystem.h (включая Windows.h)

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

MCI
Команды MCI

Поделиться через

команда MCI_SETAUDIO

Параметры

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

Комментарии

Требования

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

Обратная связь

Дополнительные ресурсы