Команда setaudio

Команда setaudio задает значения, связанные с воспроизведением и записью звука. Устройства с цифровым видео и VCR распознают эту команду.

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

_stprintf_s(
  lpszCommand, 
  TEXT("setaudio %s %s %s"), 
  lpszDeviceID, 
  lpszAudio, 
  lpszFlags
); 

Параметры

lpszDeviceID

Идентификатор устройства MCI. Этот идентификатор или псевдоним назначается при открытии устройства.

lpszAudio

Флаг для воспроизведения и захвата звука. В следующей таблице перечислены типы устройств, которые распознают команду setaudio , и флаги, используемые каждым типом.

Значение	Значение	Значение
digitalvideo	выравнивание алгоритмаалгоритма алгоритма с целочисленнымбасом с коэффициентомbitspersample для bit_count bytespersec до целочисленногочасового ввода, оставленного слева на левом томе, чтобы выключитьфактор на выходных данных	дескрипторкачества за длительностьюзаписывает запись в прямо на правом томе, чтобы факторыsamplespersec для целочисленногоисточника в поток sourcename, чтобы числов трибла, чтобы коэффициенттома к фактору
Видео	выключено на мониторе, чтобы ввестичисловой номерзаписи вне записи записи track_number выкл.	запись на запись track_number в источнике, чтобы ввестичисловой номердорожки track_number вне трека track_number

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

Значение	Значение
алгоритм алгоритма	Выбирает определенный алгоритм сжатия звука для последующей команды резервирования или записи . Поддерживаемые алгоритмы зависят от конкретного устройства. MCI определяет значения "g711", "g721", "g722", "g728", "pcm", "cdxa", "adpcm" и "adpcm4e" для алгоритма. Если устройство поддерживает имена алгоритмов "pcm", "cdxa" и "adpcm4e", оно соответствует стандартным определениям. Алгоритм cdxa был определен корпорацией Sony. Алгоритм "adpcm4e" определен корпорацией Intel. Значения "g711", "g721", "g722" и "g728" представляют собой звуковые алгоритмы, рекомендованные Международным телеграфным и телефонным консультативным комитетом (CCITT). Если указанный алгоритм конфликтует с текущим форматом файла, формат файла изменяется на формат по умолчанию для алгоритма.
выравнивание с целым числом	Задает выравнивание блоков данных относительно начала входных звуковых данных в формате волны.
басовая к фактору	Задает низкочастотный уровень звука.
bitspersample для bit_count	Задает количество битов на каждую записанную выборку. Файл сохраняется в этом формате. Этот флаг применяется только к устройствам, поддерживающим алгоритм pcm.
bytespersec в целое число	Задает среднее число байтов в секунду для записи в алгоритмах pcm и adpcm. Файл сохраняется в этом формате.
clocktime	Указывает, что время, указанное в флаге over, равно миллисекундам. Это время является абсолютным и не в ногу с воспроизведением рабочей области.
input	Изменяет флаги "bass", "treble" или "volume", чтобы он влиял на входной сигнал и изменял записанные данные. Если это возможно, это значение по умолчанию при мониторинге входных данных.
left off left on on	Включает или отключает вывод звука в левом канале. Источником аудио-презентации могут быть внешние входные данные или рабочая область. Значение по умолчанию — left on. Если существует только один канал, он включен или отключен.
левый том к фактору	Задает громкость звука левого звукового канала. Если имеется только один канал, он устанавливает его том.
монитор для вводаномера	Определяет, какие исходные входные данные будут передаваться в выходные данные VCR без изменения выбора входных данных источника записи. Тип может быть "output" или один из допустимых источников входных данных. Если число не указано, будет выбран первый вход этого типа.
выкл.	Включает или отключает звук. Источником звуковой презентации могут быть внешние входные данные или рабочая область. Эта команда одновременно влияет на левый и правый аудиоканалы. Значение по умолчанию — setaudio "on".
output	Изменяет флаги "bass", "treble" или "volume" таким образом, чтобы он изменял только воспроизводимый сигнал, а не то, что записано. Если это возможно, это значение по умолчанию при мониторинге файла.
в течение длительности	Указывает, сколько времени должно занять изменение, использующее переменную коэффициента . Единицы длительности находятся в формате текущего времени. Изменения происходят в пошаговом действии при воспроизведении рабочей области. Если воспроизведение приостановлено, изменение также приостанавливается до продолжения игры. Если параметр over не указан или не поддерживается, изменение происходит немедленно.
дескриптор качества	Указывает характеристики сжатия звука, выполняемого при записи звука в файл. Все устройства поддерживают три дескриптора "low", "medium" и "high". Значение по умолчанию зависит от устройства. Если флаг "алгоритм" не указан, корректировка "качество" применяется к текущему алгоритму. Команду quality можно использовать для определения дополнительных имен дескрипторов.
запись отключена	Очищает выбор источника звука, чтобы звук не записывался с помощью следующей команды записи .
запись в	Включает запись звуковых данных. По умолчанию используется запись звуковых данных.
запись track_number выкл.	Очищает выбор источника звука, чтобы звук не записывался с помощью следующей команды записи . "Track" позволяет выбирать независимые дорожки. Трек 2 соответствует дорожке PCM в Hi8. Если параметр track не указан, предполагается значение по умолчанию 1.
запись track_number на	Выбирает источник звука для записи с помощью следующей команды записи . "Track" позволяет выбирать независимые дорожки. Трек 2 соответствует дорожке PCM в Hi8. Если параметр track не указан, предполагается значение по умолчанию 1.
прямо прямо в	Включает или отключает вывод звука в правом канале. Источником аудио-презентации могут быть внешние входные данные или рабочая область. Значение по умолчанию — "right on". Если существует только один канал, этот флаг не действует.
правильное значение тома к фактору	Задает громкость звука в правильном звуковом канале. Если имеется только один канал, это не оказывает никакого влияния.
samplespersec в целое число	Задает частоту дискретизации для записи с помощью алгоритмов pcm и adpcm. Файл сохраняется в этом формате.
source на sourcename	Указывает источник для дигитайзера входных аудиоданных. Константы, определенные для sourcename : "left", "right", "average" и "stereo". Первые три указывают монофоническую запись, используя только левый вход, только правый вход и среднее значение двух входов.
source для вводаномера	Выбирает источник звука для записи на ленту. Тип должен быть "tuner", "line", "svideo", "aux", "generic" или "mute".
потоковая передача в число	Указывает звуковой поток, воспроизводимый из рабочей области. Если поток не указан и формат файла не определяет значение по умолчанию, будет воспроизводиться чередующийся аудиопоток, который физически является первым.
отключено track_number отслеживания	Отключает отдельную дорожку.
включение track_number отслеживания	Включает отдельную дорожку.
в трибла до коэффициента	Задает высокочастотный уровень звука.
volume to factor	Задает среднюю громкость звука для обоих звуковых каналов. Если для левого и правого томов заданы разные значения, то отношение левого к правому тому практически не изменится.

lpszFlags

Это может быть "ожидание", "уведомление", "тест" или их сочетание. Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

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

Комментарии

Для устройств VCR использование setaudio с флагом, который отключает отдельную дорожку ("отслеживание track_number выключено"), может привести к тому, что приложение получит сообщение о состоянии, указывающее, что команда не может быть выполнена. Некоторые VCR могут отключать только комбинации дорожек, но не отдельные дорожки; например, первая аудиодорожка и видеодорожка видеокассеты. В этом случае просто используйте setaudio и setvideo , чтобы продолжить отключение других дорожек, составляющих комбинацию. Драйвер отключит дорожки, когда получит команду для отключения последней дорожки в сочетании.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]

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

MCI

Командные строки MCI

record

Заповедник

setvideo