команда MCI_GETDEVCAPS

  • Статья

Команда MCI_GETDEVCAPS извлекает статические сведения об устройстве. Все устройства распознают эту команду. Параметры и флаги, доступные для этой команды, зависят от выбранного устройства. Сведения возвращаются в элементе dwReturn структуры, определяемой lpCapsParms.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_GETDEVCAPS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);

Параметры

wDeviceID

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

Dwflags

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

lpCapsParms

Указатель на структуру MCI_GETDEVCAPS_PARMS .

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

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

Комментарии

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

MCI_GETDEVCAPS_COMPOUND_DEVICE

Член dwReturn имеет значение TRUE , если устройство использует хранилище данных, которое должно быть открыто и закрыто явным образом; В противном случае устанавливается значение FALSE .

MCI_GETDEVCAPS_DEVICE_TYPE

Члену dwReturn присваивается одно из значений, перечисленных в разделе Типы устройств MCI.

MCI_GETDEVCAPS_HAS_AUDIO

Член dwReturn имеет значение TRUE , если устройство имеет аудиовыход; В противном случае устанавливается значение FALSE .

MCI_GETDEVCAPS_HAS_VIDEO

Член dwReturn имеет значение TRUE , если устройство имеет видеовыход; В противном случае устанавливается значение FALSE . Например, член имеет значение TRUE для устройств, поддерживающих набор команд videodisc.

MCI_GETDEVCAPS_ITEM

Указывает, что член dwItem структуры MCI_GETDEVCAPS_PARMS содержит одну из следующих констант:

MCI_GETDEVCAPS_CAN_EJECT

Член dwReturn имеет значение TRUE , если устройство может извлечь носитель; В противном случае устанавливается значение FALSE.

MCI_GETDEVCAPS_CAN_PLAY

Член dwReturn имеет значение TRUE , если устройство может воспроизводить мультимедиа; В противном случае устанавливается значение FALSE. Если устройство указывает значение TRUE, это означает, что оно поддерживает команды MCI_PAUSE и MCI_STOP , а также команду MCI_PLAY .

MCI_GETDEVCAPS_CAN_RECORD

Член dwReturn имеет значение TRUE , если устройство поддерживает запись; В противном случае устанавливается значение FALSE. Если устройство указывает значение TRUE, это означает, что оно поддерживает команды MCI_PAUSE и MCI_STOP, а также команду MCI_RECORD .

MCI_GETDEVCAPS_CAN_SAVE

Член dwReturn имеет значение TRUE , если устройство может сохранить файл; В противном случае устанавливается значение FALSE.

MCI_GETDEVCAPS_USES_FILES

Член dwReturn имеет значение TRUE , если для устройства требуется имя файла; В противном случае устанавливается значение FALSE . Файлы используются только на составных устройствах.

В элементе dwItemMCI_GETDEVCAPS_PARMS для типа устройства digitalvideo можно указать следующие флаги:

MCI_DGV_GETDEVCAPS_CAN_FREEZE

Член dwReturn имеет значение TRUE , если устройство может заморозить кадры; В противном случае устанавливается значение FALSE.

MCI_DGV_GETDEVCAPS_CAN_LOCK

Член dwReturn имеет значение TRUE , если устройство может заблокировать; В противном случае устанавливается значение FALSE.

MCI_DGV_GETDEVCAPS_CAN_REVERSE

Член dwReturn имеет значение TRUE , если устройство может воспроизводиться в обратном порядке; В противном случае устанавливается значение FALSE.

MCI_DGV_GETDEVCAPS_CAN_STR_IN

Член dwReturn имеет значение TRUE , если устройство может растянуть входные данные; В противном случае устанавливается значение FALSE.

MCI_DGV_GETDEVCAPS_CAN_STRETCH

Член dwReturn имеет значение TRUE , если устройство может растянуть изображение; В противном случае устанавливается значение FALSE.

MCI_DGV_GETDEVCAPS_CAN_TEST

Член dwReturn имеет значение TRUE , если устройство может выполнять тесты; В противном случае устанавливается значение FALSE.

MCI_DGV_GETDEVCAPS_HAS_STILL

Член dwReturn имеет значение TRUE , если устройство может отображать неподвижные изображения; В противном случае устанавливается значение FALSE.

MCI_DGV_GETDEVCAPS_MAX_WINDOWS

Для элемента dwReturn задано максимальное количество окон, которое устройство может обрабатывать одновременно.

MCI_DGV_GETDEVCAPS_MAXIMUM_RATE

Для элемента dwReturn устанавливается максимальная скорость воспроизведения для устройства в кадрах в секунду.

MCI_DGV_GETDEVCAPS_MINIMUM_RATE

Для элемента dwReturn устанавливается минимальная скорость воспроизведения для устройства в кадрах в секунду.

MCI_DGV_GETDEVCAPS_PALETTES

Член dwReturn имеет значение TRUE , если устройство может вернуть дескриптор палитры; В противном случае устанавливается значение FALSE.

В элементе dwItemMCI_GETDEVCAPS_PARMS для типа устройства виртуальной машины можно указать следующие флаги:

MCI_GETDEVCAPS_CLOCK_INCREMENT_RATE

Для элемента dwReturn задано число приращений в секунду.

MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH

Член dwReturn имеет значение TRUE , если устройство может определять длину носителя; В противном случае устанавливается значение FALSE.

MCI_VCR_GETDEVCAPS_CAN_FREEZE

Член dwReturn имеет значение TRUE , если устройство может заморозить выходное изображение; В противном случае устанавливается значение FALSE.

MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES

Член dwReturn имеет значение TRUE , если устройство может отслеживать источники; В противном случае устанавливается значение FALSE.

MCI_VCR_GETDEVCAPS_CAN_PREROLL

Член dwReturn имеет значение TRUE , если устройство может выполнять предварительную настройку; В противном случае устанавливается значение FALSE.

MCI_VCR_GETDEVCAPS_CAN_PREVIEW

Член dwReturn имеет значение TRUE , если устройство поддерживает предварительные версии; В противном случае устанавливается значение FALSE.

MCI_VCR_GETDEVCAPS_CAN_REVERSE

Член dwReturn имеет значение TRUE , если устройство может воспроизводиться в обратном порядке; В противном случае устанавливается значение FALSE.

MCI_VCR_GETDEVCAPS_CAN_TEST

Член dwReturn имеет значение TRUE , если устройство может тестировать; В противном случае устанавливается значение FALSE.

MCI_VCR_GETDEVCAPS_HAS_CLOCK

Член dwReturn имеет значение TRUE , если устройство поддерживает внешние часы; В противном случае устанавливается значение FALSE.

MCI_VCR_GETDEVCAPS_HAS_TIMECODE

Член dwReturn имеет значение TRUE , если устройство имеет возможность кода времени или если эта возможность неизвестна; В противном случае устанавливается значение FALSE.

MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS

Члену dwReturn присваивается количество меток (99).

MCI_VCR_GETDEVCAPS_SEEK_ACCURACY

Для элемента dwReturn задана точность поиска устройства.

В элементе dwItemMCI_GETDEVCAPS_PARMS для наложения типа устройства можно указать следующие флаги:

MCI_OVLY_GETDEVCAPS_CAN_FREEZE

Член dwReturn имеет значение TRUE , если устройство может заморозить образ; В противном случае устанавливается значение FALSE.

MCI_OVLY_GETDEVCAPS_CAN_STRETCH

Член dwReturn имеет значение TRUE , если устройство может растянуть изображение для заполнения кадра; В противном случае устанавливается значение FALSE.

MCI_OVLY_GETDEVCAPS_MAX_WINDOWS

Для элемента dwReturn задано максимальное количество окон, которое устройство может обрабатывать одновременно.

Следующие флаги можно указать в элементе dwItemMCI_GETDEVCAPS_PARMS для типа устройства videodisc :

MCI_VD_GETDEVCAPS_CAN_REVERSE

Элемент dwReturn имеет значение TRUE , если видеодиск-проигрыватель может воспроизводиться в обратном порядке; В противном случае устанавливается значение FALSE. Некоторые игроки могут воспроизводить диски CLV в обратном порядке, а также диски CAV.

MCI_VD_GETDEVCAPS_CAV

В сочетании с другими элементами указывает, что возвращаемые сведения применяются к видеодискам формата CAV. Это значение по умолчанию, если videodisc не вставлен.

MCI_VD_GETDEVCAPS_CLV

В сочетании с другими элементами указывает, что возвращаемые сведения применяются к видеодискам формата CLV.

MCI_VD_GETDEVCAPS_FAST_RATE

Для элемента dwReturn устанавливается стандартная скорость воспроизведения в кадрах в секунду.

MCI_VD_GETDEVCAPS_NORMAL_RATE

Для элемента dwReturn устанавливается обычная скорость воспроизведения в кадрах в секунду.

MCI_VD_GETDEVCAPS_SLOW_RATE

Для элемента dwReturn задана стандартная низкая скорость воспроизведения в кадрах в секунду.

В элементе dwItemMCI_GETDEVCAPS_PARMS для типа устройства waveaudio можно указать следующие флаги:

MCI_WAVE_GETDEVCAPS_INPUT

Для элемента dwReturn задается общее количество устройств ввода (записи) волнообразной формы.

MCI_WAVE_GETDEVCAPS_OUTPUT

Для элемента dwReturn задается общее количество устройств вывода (воспроизведения) волнообразной формы.

Требования

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

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

MCI

Команды MCI