Команда info

Статья
06/13/2023

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

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

_stprintf_s(
  lpszCommand, 
  TEXT("info %s %s %s"), 
  lpszDeviceID, 
  lpszInfoType, 
  lpszFlags
);

Параметры

lpszDeviceID

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

lpszInfoType

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

Значение	Значение	Значение
cdaudio	info identityinfo	product
digitalvideo	алгоритм аудиоаудио качествефайла производительности алгоритмыtill качество	usageversionvideo algorithmvideo qualitywindow text
overlay	fileproduct	текст окна
sequencer	copyrightfile	nameproduct
Видео	product	version
videodisk	product
waveaudio	fileinput	outputproduct

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

Значение	Значение
алгоритм звука	Возвращает имя текущего алгоритма сжатия звука.
качество звука	Возвращает имя текущего дескриптора качества звука. Это может возвращать значение "неизвестно", если приложение задало для параметров определенные значения, которые не соответствуют определенным качествам.
авторские права	Извлекает уведомление об авторских правах midi-файла из мета-события copyright.
файл	Извлекает имя файла, используемого составным устройством. Если устройство открыто без файла и команда загрузки не использовалась, возвращается строка null.
информационное удостоверение	Создает уникальный идентификатор звукового компакт-диска, загруженного в запрашиваемый проигрыватель.
info	Создает универсальный код продукта (КОД), который закодирован на аудио компакт-диске. КОД ПРЕДСТАВЛЯЕТ собой строку цифр. Он может быть доступен не для всех компакт-адресов.
input	Получает описание текущего устройства ввода. Возвращает значение none, если устройство ввода не задано.
name	Извлекает имя последовательности из мета-события имени последовательности или дорожки.
output	Получает описание текущего устройства вывода. Возвращает значение none, если устройство вывода не задано.
product	Получает описание устройства. Эти сведения часто включают название продукта и модель. Длина строки будет не более 31 символа.
алгоритм по-прежнему	Возвращает имя текущего алгоритма сжатия неподвижных изображений.
по-прежнему качество	Возвращает имя текущего дескриптора качества изображения. Это может возвращать значение "неизвестно", если приложение задало для параметров определенные значения, которые не соответствуют определенным качествам.
usage	Возвращает строку, описывающую ограничения использования, которые могут быть наложены владельцем визуальных или звуковых данных в рабочей области.
version	Возвращает уровень выпуска драйвера устройства и оборудования.
алгоритм видео	Возвращает имя текущего алгоритма сжатия видео.
качество видео	Возвращает имя текущего дескриптора качества видео. Это может возвращать значение "неизвестно", если приложение задало для параметров определенные значения, которые не соответствуют определенным качествам.
текст окна	Извлекает подпись окна, используемого устройством.

lpszFlags

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

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

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

Примеры

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

info mysound product

Требования

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

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

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