команда capability

  • Статья

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

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

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

Параметры

lpszDeviceID

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

lpszRequest

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

Значение Тип Тип
cdaudio
  • может извлечь
  • может играть
  • может записывать
  • может сохранить
  • составное устройство
  • тип устройства
  • имеет звук
  • имеет видео
  • использует файлы
digitalvideo
  • может извлечь
  • может заморозить
  • может заблокировать
  • может играть
  • может записывать
  • может быть обратным
  • может сохранить
  • может растянуться
  • может растянуть входные данные
  • может протестировать
  • составное устройство
  • тип устройства
  • имеет звук
  • по-прежнему
  • имеет видео
  • максимальная скорость игры
  • минимальная ставка игры
  • использует файлы
  • использует палитры
  • Windows
overlay
  • может извлечь
  • может заморозить
  • может играть
  • может записывать
  • может сохранить
  • может растянуться
  • составное устройство
  • тип устройства
  • имеет звук
  • имеет видео
  • использует файлы
  • Windows
sequencer
  • может извлечь
  • может играть
  • может записывать
  • может сохранить
  • составное устройство
  • тип устройства
  • имеет звук
  • имеет видео
  • использует файлы
Видео
  • может определить длину
  • может извлечь
  • может заморозить
  • может отслеживать источники
  • может играть
  • can preroll
  • может быть предварительным просмотром
  • может записывать
  • может быть обратным
  • может сохранить
  • может протестировать
  • частота приращения часов
  • составное устройство
  • тип устройства
  • имеет звук
  • имеет часы
  • имеет код времени
  • имеет видео
  • количество меток
  • Точность поиска
  • использует файлы
videodisc
  • может извлечь
  • может играть
  • может записывать
  • может быть обратным
  • может сохранить
  • CAV
  • CLV
  • составное устройство
  • тип устройства
  • быстрая скорость игры
  • имеет звук
  • имеет видео
  • нормальная скорость игры
  • низкая скорость игры
  • использует файлы
waveaudio
  • может извлечь
  • может играть
  • может записывать
  • может сохранить
  • составное устройство
  • тип устройства
  • имеет звук
  • имеет видео
  • Ввод данных
  • outputs
  • использует файлы

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

Флаги Значение
может определить длину Возвращает значение TRUE , если устройство может определить длину носителя.
может извлечь Возвращает значение TRUE , если устройство может извлечь носитель.
может заморозить Возвращает значение TRUE , если устройство может заморозить данные в буфере кадров.
может заблокировать Возвращает значение TRUE , если устройство может заблокировать данные.
может отслеживать источники Возвращает значение TRUE , если устройство может передавать входные данные (источник) в отслеживаемые выходные данные независимо от текущего выбора входных данных.
может играть Возвращает значение TRUE , если устройство может играть.
can preroll Возвращает значение TRUE , если устройство поддерживает флаг preroll с помощью команды подсказки .
может быть предварительным просмотром Возвращает значение TRUE , если устройство поддерживает предварительные версии.
может записывать Возвращает значение TRUE , если устройство поддерживает запись.
может быть обратным Возвращает значение TRUE , если устройство может воспроизводиться в обратном направлении.
может сохранить Возвращает значение TRUE , если устройство может сохранять данные.
может растянуться Возвращает значение TRUE , если устройство может растянуть кадры для заполнения заданного прямоугольника дисплея.
может растянуть входные данные Возвращает значение TRUE , если устройство может изменить размер изображения в процессе его оцифровки в буфер кадров.
может протестировать Возвращает значение TRUE, если устройство распознает тестовый ключевое слово.
Cav В сочетании с другими элементами этот флаг указывает, что возвращаемые сведения применяются к видеодискам формата CAV. Это значение по умолчанию, если videodisc не вставлен.
частота приращения часов Возвращает количество подразделений, поддерживаемых внешними часами в секунду. Если внешние часы равны миллисекундам, возвращаемое значение равно 1000. Если возвращаемое значение равно 0, часы не поддерживаются.
clv В сочетании с другими элементами этот флаг указывает, что возвращаемые сведения применяются к видеодискам формата CLV.
составное устройство Возвращает значение TRUE , если устройство поддерживает имя элемента (имя файла).
тип устройства Возвращает имя типа устройства, которое может иметь одно из следующих значений:
  • cdaudio
  • dat
  • digitalvideo
  • иное
  • overlay
  • средство проверки
  • sequencer
  • Видео
  • videodisc
  • waveaudio
быстрая скорость игры Возвращает быструю скорость воспроизведения в кадрах в секунду или ноль, если устройство не может быстро воспроизводиться.
имеет звук Возвращает значение TRUE , если устройство поддерживает воспроизведение звука.
имеет часы Возвращает значение TRUE , если на устройстве есть часы.
по-прежнему Возвращает значение TRUE , если устройство обрабатывает файлы с одним изображением более эффективно, чем видеофайлы движения.
имеет код времени Возвращает значение TRUE , если устройство поддерживает код времени или неизвестно.
имеет видео Возвращает значение TRUE , если устройство поддерживает видео.
Ввод данных Возвращает общее количество устройств ввода.
максимальная скорость игры Возвращает максимальную скорость воспроизведения (в кадрах в секунду) для устройства.
минимальная ставка игры Возвращает минимальную скорость воспроизведения (в кадрах в секунду) для устройства.
нормальная скорость игры Возвращает нормальную скорость воспроизведения (в кадрах в секунду) для устройства.
количество меток Возвращает максимальное количество меток, которые можно использовать; нуль указывает, что метки не поддерживаются.
outputs Возвращает общее количество устройств вывода.
Точность поиска Возвращает ожидаемую точность поиска в кадрах; 0 означает, что устройство имеет точность кадра, 1 указывает, что устройство должно находиться в пределах одного кадра указанной позиции поиска и т. д.
низкая скорость игры Возвращает низкую скорость воспроизведения в кадрах в секунду или ноль, если устройство не может воспроизводиться медленно.
использует файлы Возвращает значение TRUE , если хранилище данных, используемое составным устройством, является файлом.
использует палитры Возвращает значение TRUE , если устройство использует палитры.
Windows Возвращает количество одновременных окон отображения, которые может поддерживать устройство.

lpszFlags

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

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

Возвращает сведения в параметре lpszReturnString функции mciSendString . Сведения зависят от типа запроса.

Примеры

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

capability mysound device type

Требования

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

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

MCI

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

Cue