Команда set

Статья
06/13/2023

Примечание

Связь без предубеждений Майкрософт поддерживает разнообразную и инклюзивную среду. В этом документе есть ссылки на слово "slave". Руководство майкрософт по стилю для Bias-Free Communications распознает это как исключаемое слово. Эта формулировка используется в настоящее время в командах. Для обеспечения согласованности этот документ содержит это слово. При изменении этого слова в командах мы исправим этот документ так, чтобы он был в выравнивании.

Команда set устанавливает параметры управления для устройства. Эта команда распознана на устройствах cd audio, digital-video, MIDI sequencer, VCR, videodisc, video-overlay и waveform-audio.

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

_stprintf_s(
  lpszCommand,
  TEXT("set %s %s %s"),
  lpszDeviceID,
  lpszSetting,
  lpszFlags
);

Параметры

lpszDeviceID

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

lpszSetting

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

Тип устройства	Флаги команд
cdaudio	звук все выключено звук все включено звук не выключается аудио слева звук сразу отключено звук прямо включено дверь закрыта дверь открыта формат времени в миллисекундах формат времени msf формат времени tmsf
digitalvideo	звук все выключено звук все включено звук не выключается аудио слева звук сразу отключено звук прямо включено дверь закрыта дверь открыта формат файла искать точно на искать точно покинуть Коэффициент скорости Формат файла по-прежнему кадры формата времени формат времени в миллисекундах видео выкл. видео включено
overlay	звук все выключено звук все включено звук не выключается аудио слева звук сразу отключено звук прямо включено дверь закрыта дверь открыта видео выкл. видео включено
sequencer	звук все выключено звук все включено звук не выключается аудио слева звук сразу отключено звук прямо включено дверь закрыта дверь открыта master MIDI master нет master SMPTE время смещения сопоставителя портов порт отсутствует port_number порта Ведомый файл ведомый MIDI ведомый нет Ведомый SMPTE tempo tempo_value формат времени в миллисекундах формат времени SMPTE fps временной формат SMPTE 30 drop указатель на композицию формата времени
Видео	сборка записи в Собрать запись откл. звук все выключено звук все включено звук не выключается аудио слева звук сразу отключено звук прямо включено часы времени Формат счетчика Значение счетчика дверь закрыта дверь открыта счетчик индекса дата индекса время индекса время индекса длительность codelength приостановка времени ожидания Длительность послеролла — duration Включение питания выключение питания Длительность предварительной подготовки пакет обновления для формата записи LP в формате записи формат записи EP Коэффициент скорости кадры формата времени формат времени hms формат времени в миллисекундах формат времени msf формат времени SMPTE fps временной формат SMPTE 30 drop формат времени tmsf счетчик режима времени определение режима времени time mode timecode отслеживание плюс отслеживание минус отслеживание сброса
videodisc	звук все выключено звук все включено звук не выключается аудио слева звук сразу отключено звук прямо включено дверь закрыта дверь открыта кадры формата времени формат времени hms формат времени в миллисекундах дорожка формата времени видео выкл. видео включено
waveaudio	выравнивание целое число любые входные данные любые выходные данные звук все выключено звук все включено звук не выключается аудио слева звук сразу отключено звук прямо включено bitspersample bit_count bytespersec byte_rate каналы channel_count дверь закрыта дверь открыта format tag pcm тег тега формата входное целое число выходное целое число samplespersec целое число формат времени в байтах формат времени в миллисекундах Примеры форматов времени

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

Значение	Значение
выравнивание целое число	Задает выравнивание блоков данных относительно начала данных, передаваемых устройству waveform-audio. Файл сохраняется в этом формате.
любые входные данные	Используйте любые входные данные, поддерживающие текущий формат при записи. Это параметр по умолчанию.
любые выходные данные	Используйте любые выходные данные, поддерживающие текущий формат при воспроизведении. Это значение по умолчанию.
сборка записи в Собрать запись откл.	В режиме сборки все дорожки записываются в соответствии с определением устройства. Большинство видеомодулов по умолчанию находятся в режиме сборки.
звук все выключено звук все включено	Отключает или включает аудиовыход. Устройства с наложением видео, секвенсор MCISEQ и устройство MCIWAVE waveform-audio не поддерживают этот флаг.
звук не выключается аудио слева звук сразу отключено звук прямо включено	Отключает или включает вывод в левый или правый аудиоканал. Устройства с наложением видео, секвенсор MCISEQ и устройство MCIWAVE waveform-audio не поддерживают этот флаг.
bitspersample bit_count	Задает количество битов на воспроизводимый или записанный образец PCM (пульсовая модуляция кода). Файл сохраняется в этом формате.
bytespersec byte_rate	Задает среднее число байтов в секунду, воспроизводимых или записанных. Файл сохраняется в этом формате.
каналы channel_count	Задает каналы для воспроизведения и записи. Файл сохраняется в этом формате.
часы времени	Задает значение времени для внешних часов . Формат указывается как длинное целое число без знака.
Формат счетчика	Задайте формат времени для счетчика, возвращаемый состоянием "counter". Сведения о применимых типах см. в команде set "time format".
Значение счетчика	Задает для счетчика VCR указанное значение. Значение должно быть указано в формате текущего счетчика. Дополнительные сведения см. в разделе Команда set "counter format".
дверь закрыта	Убирает лоток и закрывает дверь, если это возможно. Для видеосети лента загружается автоматически.
дверь открыта	Открывает дверь и выбрасывает лоток или ленту, если это возможно.
формат файла	Задает формат файла, используемый для команд сохранения или записи . Если этот параметр опущен, по умолчанию может использоваться формат, определенный драйвером устройства. Если указанный формат файла конфликтует с выбранным в данный момент алгоритмом и качеством, они изменяются на значения по умолчанию для формата файла. Определены следующие форматы файлов: avi: задает формат AVI. avss: задает формат AVSS. dib: задает формат DIB. jfif: задает формат JFIF. jpeg: задает формат JPEG. mpeg: задает формат MPEG. rdib: задает формат DIB RLE. rjpeg: задает формат RJPEG.
format tag pcm	Задает тип формата PCM для воспроизведения и записи. Файл сохраняется в этом формате.
тег тега формата	Задает тип формата для воспроизведения и записи. Файл сохраняется в этом формате.
индексный код времени счетчик индекса дата индекса время индекса	Задает текущий экран отображения на виртуальной клавиатуре.
входное целое число	Задает звуковой канал, используемый в качестве входных данных.
длительность длины	Задает заданную пользователем длину ленты в VCR. Эта длина возвращается командой состояния length и предоставляется для совместимости с приложениями, которым требуется, чтобы эта команда возвращала допустимую длину.
master миди	Задает в качестве источника синхронизации секвенсор MIDI. Данные синхронизации отправляются в формате MIDI. Секвенсор MCISEQ не поддерживает этот флаг.
master нет	Запрещает секвенсору MIDI отправлять данные синхронизации. Секвенсор MCISEQ не поддерживает этот флаг.
master smpte	Задает в качестве источника синхронизации секвенсор MIDI. Данные синхронизации отправляются в формате SMPTE (Общество инженеров кино и телевидения). Секвенсор MCISEQ не поддерживает этот флаг.
время смещения	Задает время смещения SMPTE. Смещение — это время начала последовательности на основе SMPTE. Время выражается как чч: мм: ss: ff, где чч — часы, мм — минуты, ss — секунды, а ff — кадры.
выходное целое число	Задает звуковой канал, используемый в качестве выходных данных.
приостановка времени ожидания	Задает максимальную длительность команды приостановки (в миллисекундах). Значение времени ожидания , равное нулю, указывает на то, что время ожидания не будет истекло.
Длительность послеролла	Задает длину в формате текущего времени, необходимую для остановки транспорта VCR при выполнении команды остановки или приостановки .
сопоставителя портов	Задает сопоставителя MIDI в качестве порта, получающего сообщения MIDI. Эта команда завершается ошибкой, если приложение использует сопоставителя MIDI или нужный ему порт.
порт отсутствует	Отключает отправку сообщений MIDI. Эта команда также закрывает MIDI-порт.
port_number порта	Задает MIDI-порт, принимающий midi-сообщения. Эта команда завершается ошибкой, если порт, который вы пытаетесь открыть, используется другим приложением.
Включение питания выключение питания	Устанавливает для устройства значение "Включено" или "Выключено".
Длительность предварительной подготовки	Задает длину в формате текущего времени, необходимую для стабилизации выходных данных VCR.
пакет обновления для формата записи LP в формате записи формат записи EP	Устанавливает режим записи для VCR в значение SP для стандартного воспроизведения, EP для расширенного воспроизведения или LP для длительного воспроизведения. Эти значения не предназначены для конкретного VHS. Они сопоставляются с любыми тремя соответствующими режимами с другими форматами ленты. Например, sp сопоставляется с самой быстрой и высококачественной записью.
samplespersec целое число	Задает частоту выборки для воспроизведения и записи. Файл сохраняется в этом формате.
искать точно на искать точно покинуть	Выбирает один из двух режимов поиска. С параметром "seek exactly on" функция seek всегда будет перемещаться к указанному кадру. При использовании параметра seek exactly off поиск будет перемещаться к ближайшему ключевому кадру до указанного кадра.
Ведомый файл	Задает секвенсор MIDI для использования данных файлов в качестве источника синхронизации. Это параметр по умолчанию.
ведомый миди	Задает секвенсор MIDI для использования входящих данных MIDI для источника синхронизации. Секвенсор распознает данные синхронизации в формате MIDI. Секвенсор MCISEQ не поддерживает этот флаг.
ведомый нет	Задает секвенсор MIDI для игнорирования синхронизации
slave smpte	Задает секвенсор MIDI для использования входящих данных MIDI для источника синхронизации. Секвенсор распознает данные синхронизации в формате SMPTE. Секвенсор MCISEQ не поддерживает этот флаг.
коэффициент скорости	Задает относительную скорость воспроизведения видео и звука из рабочей области. Коэффициент — это соотношение между номинальной частотой кадров и требуемой частотой кадров, где номинальная частота кадров обозначается как 1000. (Скорость 500 — это половина нормальной скорости, 2000 — это в два раза нормальная скорость и так далее.) Установка нулевой скорости воспроизводит видео как можно быстрее без удаления кадров и без звука.
формат файла still	Задает формат файла, используемый для команд записи.
tempo tempo_value	Задает темп последовательности в соответствии с текущим форматом времени. Для файла на основе PPQN tempo_value интерпретируется как количество ударов в минуту. Для файла на основе SMPTE tempo_value интерпретируется как кадры в секунду.
формат времени в байтах	В формате PCM-файла задает формат времени в байтах. Все сведения о положении указываются в виде байтов после выполнения этой команды.
временные рамки формата	Задает формат времени для фреймов. Все команды, использующие значения позиции, будут принимать кадры. При открытии устройства кадры являются режимом по умолчанию. Поддерживается видеодисками с использованием формата CAV.
формат времени hms	Задает формат времени в часы, минуты и секунды. Все команды, использующие значения позиции, будут использовать HMS. HMS — это формат по умолчанию для видеодисков CLV. Укажите значение HMS в формате чч:мм:сс, где чч — часы, мм — минуты, а ss — секунды. Поле можно опустить, если оно и все следующие поля равны нулю. Например, 3, 3:0 и 3:0:0 являются допустимыми способами выражения 3 часов.
формат времени в миллисекундах	Задает формат времени в миллисекундах. Все команды, использующие значения позиции, будут принимать миллисекунды. Можно сократить миллисекунды как "ms". Для устройств sequencer файл последовательности задает формат по умолчанию PPQN или SMPTE. Устройства с наложением видео не поддерживают этот флаг.
формат времени msf	Задает формат времени в минутах, секундах и кадрах. Все команды, использующие значения позиции, будут использовать MSF (формат по умолчанию для аудио cd). Укажите значение MSF в формате mm:ss:ff, где mm — минуты, ss — секунды, а ff — кадры. Поле можно опустить, если оно и все следующие поля равны нулю. Например, 3, 3:0 и 3:0:0 являются допустимыми способами выражения 3 минуты. Поля MSF имеют следующие максимальные значения: Минуты 99 Секунды 59 Кадры 74
Примеры форматов времени	Задает формат времени для примеров. Все сведения о положении указываются в качестве примеров после выполнения этой команды.
time format smpte 24 time format smpte 25 time format smpte 30	Задает формат времени для частоты кадров SMPTE. Для VCR задает формат времени чч:мм:сс:ff, где допустимые значения от 00:00:00:00:00 до 23:59:59:xx, а xx на единицу меньше кадров в секунду, как указано числом 24, 25 или 30, как указано в флаге. На входе двоеточие (:) требуются для разделения компонентов. Наименьшие значимые единицы можно опустить, если они имеют значение 00; Например, 02:00 совпадает с 02:00:00:00. Все команды, использующие значения позиции, будут использовать формат SMPTE. Файл последовательности задает формат по умолчанию PPQN или SMPTE.
time format smpte 30 drop	Задает формат времени для частоты кадров сброса SMPTE 30. Для VCR, аналогично SMPTE 30, за исключением того, что некоторые позиции таймкода удаляются из формата, чтобы записанные позиции таймкода для каждого кадра (при частоте кадров NTSC 29,97 кадров/с) соответствовали реальному времени (30 кадров/с). Позиции кода времени, которые удаляются, следующие: по две минуты в минуту для первых девяти из каждых десяти минут записанного содержимого. Например, в 01:04:59:29 следующей позицией timecode будет 01:05:00:02, а не 01:05:00:00. Все команды, использующие значения позиции, будут использовать формат SMPTE. Файл последовательности задает формат по умолчанию PPQN или SMPTE.
указатель на композицию формата времени	Задает формат времени для указателя песни (шестнадцатые заметки). Все команды, использующие значения позиции, будут принимать единицы указателя песни. Этот флаг действителен только для последовательности ppqn типа деления.
time format tmsf	Задает формат времени для дорожек, минут, секунд и кадров. Все команды, использующие значения позиции, будут использовать TMSF. Укажите значение TMSF как tt:mm:ss:ff, где tt — треки, mm — минуты, ss — секунды, а ff — кадры. Поле можно опустить, если оно и все следующие поля равны нулю. Например, 3, 3:0, 3:0:0 и 3:0:0:0 являются допустимыми способами выражения дорожки 3. Поля TMSF имеют следующие максимальные значения: Треки 99 Минуты 90 Секунды 59 Кадры 74
дорожка формата времени	Задает формат позиции для дорожек. Все команды, использующие значения позиции, будут принимать дорожки.
счетчик режима времени	Задает режим сведений о позиции для использования счетчиков VCR.
time mode detect	Задает режим сведений о положении на основе обнаружения сведений о коде времени на ленте. При обнаружении сведений о коде времени для типа времени устанавливается значение timecode; в противном случае для типа времени задано значение "counter". "Обнаружение" — это специальный режим. При каждом открытии драйвера, вставке новой ленты или выполнении команды "режим времени" драйвер проверяет текущий режим времени, доступный на ленте, и устанавливает для параметра "тип времени" значение "timecode" или "counter". После установки параметра "тип времени" драйвер не изменяет его, пока не возникнет одно из указанных выше условий.
time mode timecode	Задает режим сведений о положении для использования сведений о времени на ленте.
отслеживание плюс отслеживание минус отслеживание сброса	Корректирует скорость транспортировки видеокассеты с приращением. Используйте флаги отслеживания при получении шумного изображения из VCR. "Отслеживание плюс" увеличивает скорость транспорта. "Отслеживание минус" снижает скорость транспорта. "Сброс отслеживания" возвращает корректировку отслеживания до нуля.
видео выкл.	Отключает вывод видео.
видео включено	Включает вывод видео.

lpszFlags

Может иметь значение "wait", "notify" или и то, и другое. Для цифровых видеоустройств и виртуальных машин также можно указать "test". Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

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

При создании файла для хранения данных определяется несколько свойств данных waveform-audio. Эти свойства описывают структуру данных в файле и их невозможно изменить после начала записи. Эти свойства определены в следующем списке:

выравнивание
bitspersample
bytespersec
каналов
тег format
samplespersec

Примеры

Следующая команда задает формат времени в миллисекундах, а формат waveform-audio — 8 бит, моно, 11 кГц.

set mysound time format ms bitspersample 8 channels 1 samplespersec 11025

Требования

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

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

MCI
Командные строки MCI
Захвата
pause
сохранить
stop