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

команда status

  • Статья

Примечание

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

Команда состояния запрашивает сведения о состоянии с устройства. Все устройства распознают эту команду.

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

_stprintf_s(
  lpszCommand,
  TEXT("status %s %s %s"),
  lpszDeviceID,
  lpszRequest,
  lpszFlags
);

Параметры

lpszDeviceID

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

lpszRequest

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

Тип устройства Флаги запроса
cdaudio
  • номер дорожки типа cdaudio
  • текущая дорожка
  • length
  • длина номера дорожки
  • присутствует мультимедиа
  • mode
  • количество дорожек
  • position
  • номер трека позиции
  • Готов
  • начальная позиция
  • формат времени
digitalvideo
  • звук
  • Выравнивание звука
  • audio bitspersample
  • аудиоразрывы
  • audio bytespersec
  • аудиовход
  • аудиозапись
  • источник звука
  • аудио примерыpersec
  • аудиопоток
  • Бас
  • bitsperpel
  • brightness
  • color
  • контрастность
  • текущая дорожка
  • дисковое пространство
  • завершение файла
  • формат файлов
  • режим файла
  • forward
  • пропущенные кадры
  • gamma
  • input
  • левый том
  • length
  • длина номера дорожки
  • присутствует мультимедиа
  • mode
  • monitor
  • Метод monitor
  • Номинальный
  • номинальная частота кадров
  • номинальная частота кадров записи
  • количество дорожек
  • output
  • Дескриптор палитры
  • режим приостановки
  • Скорость воспроизведения
  • position
  • номер трека позиции
  • Готов
  • частота кадров записи
  • опорная рамка
  • зарезервированный размер
  • правый том
  • искать точно
  • Резкость
  • Smpte
  • Скорость
  • начальная позиция
  • Формат файла по-прежнему
  • формат времени
  • Оттенок
  • Вч
  • Несохраненные
  • видео
  • индекс ключа видео
  • цвет клавиши видео
  • запись видео
  • источник видео
  • номер источника видео
  • видеопоток
  • том
  • дескриптор окна
  • окно отображается
  • свернуто окно
  • развернутое окно
overlay
  • медиа-презентации
  • mode
  • количество дорожек
  • Готов
  • растяжение
  • дескриптор окна
sequencer
  • текущий трек
  • Тип деления
  • length
  • длина номера дорожки master
  • медиа-презентации
  • mode
  • количество дорожек
  • offset
  • порт
  • position
  • номер дорожки позиции
  • Готов
  • Раб
  • начальная позиция
  • Темп
  • формат времени
Видео
  • сбор записи
  • аудиомониометр
  • номер звукового монитора
  • аудиозапись
  • номер дорожки аудиозаписи
  • источник звука
  • номер источника звука
  • channel
  • Номер тюнера канала
  • clock
  • clock id
  • Счетчик
  • формат счетчика
  • разрешение счетчика
  • текущий трек
  • частота кадров
  • index
  • index on
  • length
  • длина номера дорожки
  • медиа-презентации
  • тип носителя
  • mode
  • количество звуковых дорожек
  • количество дорожек
  • количество видеодорожков
  • время ожидания приостановки
  • формат воспроизведения
  • position
  • position start
  • номер дорожки позиции
  • Длительность послеролла
  • включение
  • Длительность предварительной подготовки
  • Готов
  • Формат записи
  • Скорость
  • формат времени
  • режим времени
  • тип времени
  • присутствует код времени
  • запись кода времени
  • Тип таймкода
  • номер тюнера
  • видеомониометр
  • номер видеомониометра
  • запись видео
  • номер дорожки для записи видео
  • источник видео
  • номер источника видео
  • Запись защищена
videodisc
  • текущий трек
  • Размер диска
  • forward
  • length
  • длина номера дорожки
  • медиа-презентации
  • тип носителя
  • mode
  • количество дорожек
  • position
  • номер дорожки позиции
  • Готов
  • Стороне
  • Скорость
  • начальная позиция
  • формат времени
waveaudio
  • выравнивание
  • bitspersample
  • bytespersec
  • каналов
  • текущий трек
  • тег format
  • input
  • length
  • длина номера дорожки
  • уровень
  • медиа-презентации
  • mode
  • количество дорожек
  • output
  • position
  • номер дорожки позиции
  • Готов
  • samplespersec
  • начальная позиция
  • формат времени

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

Значение Значение
выравнивание Возвращает выравнивание блоков данных в байтах.
сбор записи Возвращает значение TRUE , если устройство настроено для записи в режиме сборки.
звук Возвращает значение "on" или "off" в зависимости от последней команды setaudio "on" или "off". Он возвращает значение "вкл.", если включен один или оба динамика, и "выкл." в противном случае.
выравнивание звука Возвращает выравнивание блоков данных относительно начала входных звуковых данных в формате волны.
audio bitspersample Возвращает количество битов на образец, который устройство использует для записи. Этот флаг применяется только к устройствам, поддерживающим алгоритм pcm.
звуковые перерывы Возвращает количество раз, когда аудио часть последней последовательности AVI разбивалась. Система подсчитывает звуковой перерыв при попытке записать звуковые данные в драйвер устройства и обнаруживает, что драйвер уже воспроизводил все доступные данные. Этот флаг распознается только драйвером цифрового видео MCIAVI. Он предназначен только для оценки производительности; возвращаемое значение трудно интерпретировать.
audio bytespersec Возвращает среднее количество байтов в секунду, используемых для записи.
аудиовход Возвращает приблизительный уровень мгновенного звука аналогового входного звукового сигнала. Значение больше 1000 подразумевает искажение обрезки. Некоторые устройства могут возвращать это значение только во время записи звука. Значение не имеет связанной команды set или setaudio .
аудиомониометр Возвращает "output" или один из допустимых исходных входных типов. Дополнительные сведения см. в разделе Команда setaudio "monitor".
номер звукового монитора Возвращает номер отслеживаемого видео типа, заданного состоянием "звуковой монитор". Дополнительные сведения см. в разделе команда setaudio .
аудиозапись Возвращает значение "on" или "off", отражающее состояние, заданное setaudio "record".
номер дорожки аудиозаписи Возвращает значение TRUE , если для VCR настроена запись звука. Если номер дорожки не указан, предполагается значение по умолчанию 1.
примеры звукаpersec Возвращает количество записанных выборок в секунду.
источник звука Возвращает текущий источник дигитайзера аудио: "left", "right", "average" или "stereo".
номер источника звука Возвращает номер источника звука типа, возвращаемого состоянием "источник аудио". Дополнительные сведения см. в разделе команда setaudio .
аудиопоток Возвращает текущий номер аудиопотока.
Бас Возвращает текущий уровень аудио-баса.
bitsperpel Возвращает количество битов на пиксель для сохранения записанных или записанных данных.
bitspersample Возвращает биты на выборку.
brightness Возвращает текущий уровень яркости видео.
bytespersec Возвращает среднее число байтов в секунду, воспроизводимых или записанных.
Номер дорожки типа cdaudio Возвращает тип указанного номера дорожки. Это может быть "аудио" или "другое".
channel Возвращает целочисленное значение канала, заданного в тюнере.
Номер тюнера канала Если задан номер "тюнер", возвращается текущий выбранный канал для номера логического тюнера. Обратите внимание, что может быть несколько логических тюнеров.
каналов Возвращает количество заданных каналов (1 для моно, 2 для стерео).
clock Возвращает внешнее время. Значение time должно быть длинным целым числом без знака, которые выражают общие приращения. Дополнительные сведения см. в статье о возможности команды "частота приращения часов".
clock id Возвращает уникальное целое число, определяющее часы.
color Возвращает текущий уровень цвета.
контрастность Возвращает текущий уровень контрастности.
Счетчик Возвращает позицию счетчика в текущем формате счетчика.
формат счетчика Возвращает текущий формат счетчика. Дополнительные сведения см. в разделе Команда set "counter format".
Разрешение счетчика Возвращает "кадры" или "секунды", указывая разрешение счетчика. Это не то же самое, что точность.
текущая дорожка Возвращает текущую дорожку. Секвенсор MCISEQ возвращает значение 1.
Размер диска Возвращает значение 8 или 12, указывающее размер загруженного диска в дюймах.
дисковое пространство Возвращает приблизительное дисковое пространство в формате текущего времени, которое можно получить с помощью команды резервирования для указанного диска .Диск обычно указывается в виде одной буквы или одной буквы, за которой следует двоеточие (:). Однако некоторые устройства могут использовать путь.
Тип деления Возвращает один из следующих типов разделов файлов:
  • PPQN
  • Кадр SMPTE 24
  • Кадр SMPTE 25
  • Кадр сброса SMPTE 30
  • Кадр SMPTE 30

Эти сведения используются для определения формата MIDI-файла и значения данных о темпе и положении.
завершение файла Возвращает предполагаемый процент выполнения операции загрузки, сохранения, записи, вырезания, копирования, удаления, вставки или отмены. (Приложения могут использовать его для предоставления визуального индикатора хода выполнения.)
формат файлов Возвращает текущий формат файла для команд записи или сохранения .
режим файла Возвращает "loading", "saving", "editing" или "idle". Во время операции загрузки возвращается "загрузка". Во время операций сохранения и записи возвращается "сохранение". Во время операций выреза,копирования, удаления, вставки или отмены возвращается "редактирование".
тег format Возвращает тег формата.
forward Возвращает значение TRUE , если направление воспроизведения вперед или если устройство не воспроизводит.
частота кадров Возвращает количество кадров в секунду, которое устройство будет использовать по умолчанию. Устройства NTSC возвращают 30, PAL 25 и т. д.
пропущенные кадры Возвращает количество кадров, которые не были нарисованы при воспроизведении последней последовательности AVI. Этот флаг распознается только драйвером цифрового видео MCIAVI. Он предназначен только для оценки производительности; возвращаемое значение трудно интерпретировать.
gamma Возвращает значение, заданное со значением setvideo "gamma to".
index Возвращает текущее отображение индекса. Дополнительные сведения см. в разделе Команда set "index".
index on Возвращает значение TRUE , если индекс включен.
input Возвращает входной набор. Если он не задан, возвращаемая ошибка указывает, что можно использовать любое устройство. Для цифровых видеоустройств изменяет флаги "bass", "treble", "volume", "brightness", "color", "contrast", "gamma", "sharpness" или "tint" таким образом, чтобы он применялись только к входным данным. Это значение по умолчанию при мониторинге входных данных.
левый том Возвращает набор громкости для левого звукового канала.
length Возвращает общую длину носителя в формате текущего времени. Для PPQN-файлов длина возвращается в единицах указателя песни. Для файлов SMPTE он возвращается как чч:мм:сс:ff, где чч — часы, мм — минуты, ss — секунды, а ff — кадры. Для устройств VCR длина составляет 2 часа (если длина не была явно изменена с помощью команды set ).
длина номера дорожки Возвращает длину дорожки во времени или кадрах, заданных числом. Для PPQN-файлов длина возвращается в единицах указателя песни. Для файлов SMPTE он возвращается как чч:мм:сс:ff, где чч — часы, мм — минуты, ss — секунды, а ff — кадры.
уровень Возвращает текущее значение образца аудиофайла PCM.
master Возвращает "midi", "none" или "smpte" в зависимости от типа набора синхронизации.
присутствует мультимедиа Возвращает значение TRUE , если носитель вставлен в устройство, или false в противном случае. Устройства Sequencer, video-overlay, digital-video и waveform-audio возвращают значение TRUE.
Тип носителя Возвращает тип носителя. Для VCRS это "8mm", "vhs", "svhs", "beta", "Hi8", "edbeta" или "other". Для videodiscs это "CAV", "CLV" или "other", в зависимости от типа videodisc.
mode Возвращает текущий режим устройства. Все устройства могут возвращать значения "not ready", "paused", "playing" и "stopped". Некоторые устройства могут возвращать дополнительные значения "open", "parked", "recording" и "seeking".
monitor Возвращает "file" или "input". Возвращаемое значение указывает текущий источник презентации.
Метод monitor Возвращает "pre", "post" или "direct". Возвращаемое значение указывает метод, используемый для мониторинга входных данных.
Номинальный Элемент изменяет флаги "bass", "brightness", "color", "contrast", "gamma", "sharpness", "tint", "treble" и "volume" для возврата номинального значения вместо текущего параметра.
номинальная частота кадров Возвращает номинальную частоту кадров, связанную с файлом. Единицы измерения отображаются в кадрах в секунду, умноженных на 1000.
номинальная частота кадров записи Возвращает номинальную частоту кадров, связанную с входным видеосигналом. Единицы измерения отображаются в кадрах в секунду, умноженных на 1000.
количество звуковых дорожек Возвращает количество звуковых дорожек на носителе.
количество дорожек Возвращает количество дорожек на носителе. Устройства MCISEQ и MCIWAVE возвращают 1, как и большинство устройств VCR. Устройство MCIPIONR не поддерживает этот флаг.
количество видеодорожек Возвращает количество видеодорожок на носителе.
offset Возвращает смещение файла на основе SMPTE. Смещение — это время начала последовательности на основе SMPTE. Время возвращается как чч:мм:сс:ff, где чч — часы, мм — минуты, ss — секунды, а ff — кадры.
output Возвращает текущий набор выходных данных. Если выходные данные не заданы, возвращаемая ошибка указывает, что можно использовать любое устройство. Для цифровых видеоустройств изменяет флаги "bass", "treble", "volume", "brightness", "color", "contrast", "gamma", "sharpness" или "tint" таким образом, чтобы они применялись только к выходным данным. Это значение по умолчанию при мониторинге файла.
режим приостановки Возвращает "запись", если устройство приостановлено во время записи. Он возвращает значение "воспроизведение", если устройство приостановлено во время воспроизведения. Если устройство не приостановлено, возвращается сообщение об ошибке "Действие неприменимо в текущем режиме".
приостановка времени ожидания Возвращает максимальную длительность команды приостановки (в миллисекундах).
Формат воспроизведения Возвращает код, указывающий формат, в котором будет воспроизводиться видеопленка, если ее можно обнаружить: "lp", "ep", "sp" или "other". Дополнительные сведения см. в разделе о флаге "формат записи".
Скорость воспроизведения Возвращает значение, указывающее, насколько точно фактическое время воспроизведения последней последовательности AVI совпадает с целевым временем воспроизведения. Значение 1000 указывает, что целевое время и фактическое время были одинаковыми. Например, значение 2000 указывает, что последовательность AVI занимает в два раза больше времени, чем должно быть. Этот флаг распознается только драйвером цифрового видео MCIAVI. Он предназначен только для оценки производительности; возвращаемое значение трудно интерпретировать.
порт Возвращает номер порта MIDI, назначенный последовательности.
position Возвращает текущую позицию. Для PPQN-файлов позиция возвращается в единицах указателя композиции. Для файлов SMPTE он возвращается как чч:мм:сс:ff, где чч — часы, мм — минуты, ss — секунды, а ff — кадры.
позиционный запуск Возвращает позицию начала пригодного для использования носителя.
номер трека позиции Возвращает позицию начала дорожки, заданной числом. Для PPQN-файлов формат времени возвращается в единицах указателя песни. Для файлов SMPTE он возвращается как чч:мм:сс:ff, где чч — часы, мм — минуты, ss — секунды, а ff — кадры. Секвенсор MCISEQ возвращает ноль. Устройство MCIPIONR не поддерживает этот флаг. Устройство MCIWAVE возвращает ноль.
продолжительность послеролла Возвращает длину видеокассети в формате текущего времени, необходимую для тормоза транспорта виртуальной машины при выполнении команды остановки или приостановки .
Включение питания Если функция VCR включена, возвращает значение TRUE .
Длительность предварительной подготовки Возвращает длину видеокассети в формате текущего времени, необходимую для стабилизации выходных данных VCR.
Готов Возвращает значение TRUE , если устройство готово к принятию другой команды.
Формат записи Возвращает код, указывающий формат, в котором будет записываться видеокассета. Текущие типы возвращаемых значений: "lp", "ep", "sp" или "other". Эти форматы не относятся к VHS и могут применяться к любым VCR с несколькими выбираемыми форматами записи. Тип "sp" является самым быстрым и высококачественным форматом записи и используется по умолчанию для видеофиксаторов с одним форматом.
частота кадров записи Возвращает частоту кадров в кадрах в секунду, умноженную на 1000, используемую для сжатия.
опорная рамка Возвращает номер кадра для ближайшего изображения ключевого кадра, предшествующего указанному кадру.
зарезервированный размер Возвращает размер зарезервированной рабочей области в формате текущего времени. Размер соответствует приблизительному времени, необходимому для воспроизведения сжатых данных из полной рабочей области. Если зарезервированного места на диске нет, возвращается ноль. Этот флаг возвращает приблизительный размер, так как точное дисковое пространство для сжатых данных, как правило, не может быть спрогнозировано до тех пор, пока данные не будут сжаты.
правый том Возвращает набор громкости для правильного звукового канала.
samplespersec Возвращает количество воспроизводимых или записанных выборок в секунду.
искать точно Возвращает значение "on" или "off", указывающее, установлен ли флаг "seek exactly".
Резкость Возвращает текущий уровень резкости устройства.
Стороне Возвращает значение 1 или 2, чтобы указать, какая сторона видеодиска загружена.
Раб Возвращает "file", "midi", "none" или "smpte" в зависимости от типа набора синхронизации.
Smpte Возвращает код времени SMPTE, связанный с текущей позицией в рабочей области. Это строка в формате dd:dd:dd:dd:dd, где каждый d обозначает цифру от 0 до 9. Если данные рабочей области не содержат данные таймкода, этот флаг возвращает значение 00:00:00:00.
Скорость Возвращает текущую скорость устройства в кадрах в секунду (или в том же формате, который используется командой set "speed"). Проигрыватель видеодиска MCIPIONR не поддерживает этот флаг.
начальная позиция Возвращает начальную позицию носителя.
Формат файла по-прежнему Возвращает текущий формат файла для команды записи .
растяжение Если растягивание включено, возвращает значение TRUE .
Темп Возвращает текущий темп последовательности MIDI в формате текущего времени. Для файлов с форматом PPQN темп в минуту. Для файлов с форматом SMPTE темп в кадрах в секунду.
формат времени Возвращает формат текущего времени. Дополнительные сведения см. в разделе Форматы времени в команде set .
режим времени Возвращает текущий режим времени позиции. Это может быть "detect", "timecode" или "counter".
Тип времени Возвращает текущее используемое время позиции: "timecode" или "counter".
присутствует код времени Возвращает значение TRUE , если код времени был записан в текущей позиции на ленте. Код времени должен переходить от текущей позиции. Чтобы проверка это условие, может потребоваться воспроизвести VCR.
запись таймкода Возвращает значение TRUE , если для VCR задано значение записи кода времени.
Тип таймкода Возвращает "smpte", "smpte drop", "other" или "none". Обратите внимание, что кадры в секунду можно получить с помощью команды состояния "частота кадров", а точность устройства может быть возвращена с помощью команды "поиск точности".
Оттенок Возвращает текущий уровень оттенка видео.
Вч Возвращает текущий уровень звука в три уровня.
номер тюнера Возвращает текущий номер логического тюнера.
Несохраненные Возвращает значение TRUE , если в рабочей области есть записанные данные, которые могут быть потеряны в результате выполнения команды закрытия, загрузки, записи, резервирования, вырезания, удаления или вставки . В противном случае возвращает значение FALSE .
видео Возвращает значение "on" или "off", отражающее состояние, заданное командой setvideo .
цвет клавиши видео Возвращает значение для цвета ключа.
индекс ключа видео Возвращает значение индекса ключа.
видеомонитатор Возвращает "выходные данные" или один из допустимых типов входных данных источника. Дополнительные сведения см. в разделе команда setvideo "monitor".
номер видеомониометра Возвращает номер отслеживаемого видео типа, возвращаемого состоянием "видеомониометр". Дополнительные сведения см. в команде setvideo .
запись видео Возвращает значение "on" или "off", отражая текущее состояние, заданное setvideo "record".
номер записи видео Возвращает значение TRUE , если VCR настроен на запись видео. Если номер дорожки не указан, предполагается значение по умолчанию 1.
источник видео Возвращает тип источника видео. Дополнительные сведения см. в команде setvideo .
номер источника видео Возвращает число, соответствующее источнику видео используемого типа. Например, он возвращает значение 2, если используется второй входный код источника видео NTSC.
видеопоток Возвращает текущий номер видеопотока.
том Возвращает среднюю громкость для левого и правого динамиков. Это возвращает ошибку, если устройство не было воспроизведено или громкость не задана.
дескриптор окна Возвращает десятичное значение ASCII для дескриптора окна в слове низкого порядка возвращаемого значения.
окно развернуто Возвращает значение TRUE , если окно развернуто.
свернуто окно Возвращает значение TRUE , если окно свернуто.
окно отображается Возвращает значение TRUE , если окно не скрыто.
запись защищена Возвращает значение TRUE , если устройство обнаруживает, что ему не удается выполнить запись (т. е. если включена защита от записи). Если он может записывать данные или не может определить, может ли он записывать (без записи), драйвер возвращает значение FALSE.

lpszFlags

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

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

Возвращает сведения в параметре lpszReturnStringmciSendString. Сведения зависят от типа запроса.

Комментарии

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

Примеры

Следующая команда возвращает текущий режим устройства mysound.

status mysound mode

Требования

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

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

MCI

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

capability;

Захвата

close

Вырезать

delete

загрузка

pause

Вставить

record

Заповедник

сохранить

set

setaudio

setvideo

stop

отменить