команда MCI_INFO

  • Статья

Команда MCI_INFO извлекает сведения о строке с устройства. Все устройства распознают эту команду. Сведения возвращаются в элементе lpstrReturn структуры, определяемой lpInfo. Член dwRetSize указывает длину буфера для возвращаемых данных.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_INFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_INFO_PARMS) lpInfo
);

Параметры

wDeviceID

Идентификатор устройства MCI, которое будет получать сообщение команды.

Dwflags

MCI_NOTIFY, MCI_WAIT или для устройств с цифровым видео и VCR MCI_TEST. Сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

lpInfo

Указатель на структуру MCI_INFO_PARMS . (Устройства с расширенными наборами команд могут заменить эту структуру структурой для конкретного устройства.)

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

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

Комментарии

Следующий дополнительный стандартный и командный флаг применяется ко всем устройствам, поддерживающим MCI_INFO:

MCI_INFO_PRODUCT

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

К типу устройства cdaudio применяются следующие дополнительные флаги:

MCI_INFO_MEDIA_IDENTITY

Создает уникальный идентификатор звукового компакт-диска, загруженного в запрашиваемый проигрыватель. Этот флаг возвращает строку из 16 шестнадцатеричных цифр.

MCI_INFO_MEDIA_UPC

Создает универсальный код продукта (КОД), который закодирован на аудио компакт-диске. КОД ПРЕДСТАВЛЯЕТ собой строку цифр. Он может быть доступен не для всех компакт-адресов.

Следующие дополнительные флаги применяются к типу устройства digitalvideo :

MCI_DGV_INFO_ITEM

Константа, указывающая на нужную информацию, включена в элемент dwItem структуры, определяемой lpInfo. Для устройств цифрового видео определены следующие константы:

MCI_DGV_INFO_AUDIO_ALG

Возвращает имя для текущего алгоритма сжатия звука.

MCI_DGV_INFO_AUDIO_QUALITY

Возвращает имя текущего дескриптора качества звука.

MCI_DGV_INFO_STILL_ALG

Возвращает имя текущего алгоритма сжатия неподвижных изображений.

MCI_DGV_INFO_STILL_QUALITY

Возвращает имя текущего дескриптора качества изображения.

MCI_DGV_INFO_USAGE

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

MCI_DGV_INFO_VIDEO_ALG

Возвращает имя текущего алгоритма сжатия видео.

MCI_DGV_INFO_VIDEO_QUALITY

Возвращает имя текущего дескриптора качества видео.

MCI_INFO_VERSION

Возвращает уровень выпуска драйвера устройства и оборудования. Разработчики драйверов устройств должны задокументировать синтаксис возвращаемой строки.

MCI_DGV_INFO_TEXT

Получает подпись окна.

MCI_INFO_FILE

Получает путь и имя последнего файла, указанные с помощью команды MCI_OPEN или MCI_LOAD . Если файл не указан, устройство возвращает строку, завершаемую null. Этот флаг поддерживается только устройствами, возвращающими значение TRUE флагу MCI_GETDEVCAPS_USES_FILES команды MCI_GETDEVCAPS .

Для цифровых видеоустройств lpInfo указывает на структуру MCI_DGV_INFO_PARMS .

Следующие дополнительные флаги применяются к типу устройства sequencer :

MCI_INFO_COPYRIGHT

Получает уведомление об авторских правах на файл MIDI из мета-события авторских прав.

MCI_INFO_FILE

Получает имя текущего файла. Этот флаг поддерживается только устройствами, которые возвращают значение TRUE при вызове команды MCI_GETDEVCAPS с флагом MCI_GETDEVCAPS_USES_FILES.

MCI_INFO_NAME

Получает имя последовательности из мета-события имени последовательности или дорожки.

Следующий дополнительный флаг применяется к типу устройства vcr :

MCI_VCR_INFO_VERSION

Задает элемент lpstrReturn структуры MCI_INFO_PARMS , указывающий на номер версии. Также задает член dwRetSize , равный длине строки, на который указывает.

К типу устройства наложения применяются следующие дополнительные флаги:

MCI_INFO_FILE

Получает имя текущего файла. Этот флаг поддерживается только устройствами, возвращающими значение TRUE флагу MCI_GETDEVCAPS_USES_FILES команды MCI_GETDEVCAPS .

MCI_OVLY_INFO_TEXT

Получает подпись окна, связанного с устройством наложения видео.

Следующие дополнительные флаги применяются к типу устройства waveaudio :

MCI_INFO_FILE

Получает имя текущего файла. Этот флаг поддерживается устройствами, которые возвращают значение TRUE при вызове команды MCI_GETDEVCAPS с флагом MCI_GETDEVCAPS_USES_FILES.

MCI_WAVE_INPUT

Получает имя продукта текущего входного значения.

MCI_WAVE_OUTPUT

Получает имя продукта для текущих выходных данных и его значение зависит от устройства.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Mmsystem.h (включая Windows.h)

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

MCI

Команды MCI