команда 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 [только классические приложения] |