Mci_getdevcaps

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

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

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

Аргументы

0. wDeviceID — идентификатор устройства MCI, которому посылается данное командное сообщение.

1. dwFlags — Флаги сообщения MCI_NOTIFY, MCI_WAIT или для видеомагнитофона и устройства вывода видео информации MCI_TEST. Кроме того, для сообщения MCI_GETDEVCAPS определены следующие флаги:

2. Данные флаги могут устанавливаться для всех устройств, обрабатывающих сообщение MCI_GETDEVCAPS:

• MCI_GETDEVCAPS_COMPOUND_DEVICE — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство использует систему хранения информации, которая может явным образом открываться и закрываться, и значение FALSE в противном случае.

• MCI_GETDEVCAPS_DEVICE_TYPE — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится одна из следующих констант:

MCI_ALL_DEVICE_ID — любое устройство.

MCI_DEVTYPE_ANIMATION — устройство анимационного воспроизведения.

MCI_DEVTYPE_CD_AUDIO — лазерный проигрыватель.

MCI_DEVTYPE_DAT — цифровой аудио магнитофон.

MCI_DEVTYPE_DIGITAL_VIDEO — устройство воспроизведения видеоинформации.

MCI_DEVTYPE_OTHER — тип устройства не определён.

MCI_DEVTYPE_OVERLAY — устройство наложения видеоинформации.

MCI_DEVTYPE_SCANNER — сканер.

MCI_DEVTYPE_SEQUENCER — устройства воспроизведения аудио информации в формате MIDI.

MCI_DEVTYPE_VCR — кассетный видеомагнитофон.

MCI_DEVTYPE_VIDEODISC — плеер видеодисков.

MCI_DEVTYPE_WAVEFORM_AUDIO — устройства воспроизведения аудио информации в формате ИКМ.

• MCI_GETDEVCAPS_HAS_AUDIO — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство имеет аудио выход, и значение FALSE в противном случае.

• MCI_GETDEVCAPS_HAS_VIDEO — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство имеет видео выход, и значение FALSE в противном случае. Например, эта переменная принимает значение TRUE для устройств, поддерживающих набор команд видеодиска.

• MCI_GETDEVCAPS_ITEM — в переменной dwItem объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится одна из следующих констант:

MCI_GETDEVCAPS_CAN_EJECT — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если носитель информации может быть удалён из устройства, и значение FALSE в противном случае.

MCI_GETDEVCAPS_CAN_PLAY — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно воспроизводить информацию с носителя, и значение FALSE в противном случае. Возвращение значения TRUE означает, что данное устройство обрабатывает команды MCI_PLAY, MCI_PAUSE и MCI_STOP.

MCI_GETDEVCAPS_CAN_RECORD — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно записывать информацию на носитель, и значение FALSE в противном случае. Возвращение значения TRUE означает, что данное устройство обрабатывает команды MCI_RECORD, MCI_PAUSE и MCI_STOP.

MCI_GETDEVCAPS_CAN_SAVE — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно записывать информацию в файл, и значение FALSE в противном случае.

MCI_GETDEVCAPS_USES_FILES — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство требует указания имени файла, и значение FALSE в противном случае. Этот флаг может быть установлен только для устройств, система хранения которых может открываться и закрываться.

Перечисленные ниже константы могут содержаться в переменной dwItem объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms для устройств типа digitalvideo:

MCI_DGV_GETDEVCAPS_CAN_FREEZE — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно воспроизводить отдельные кадры, и значение FALSE в противном случае.

MCI_DGV_GETDEVCAPS_CAN_LOCK — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно блокироваться, и значение FALSE в противном случае.

MCI_DGV_GETDEVCAPS_CAN_REVERSE — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно осуществлять воспроизведение в обратном направлении, и значение FALSE в противном случае.

MCI_DGV_GETDEVCAPS_CAN_STR_IN — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно растягивать вводимое изображение, и значение FALSE в противном случае.

MCI_DGV_GETDEVCAPS_CAN_STRETCH — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно растягивать изображение, и значение FALSE в противном случае.

MCI_DGV_GETDEVCAPS_CAN_TEST — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно производить проверку, и значение FALSE в противном случае.

MCI_DGV_GETDEVCAPS_HAS_STILL — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно выводить неподвижные изображения, и значение FALSE в противном случае.

MCI_DGV_GETDEVCAPS_MAX_WINDOWS — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится максимальное число окон с которыми устройство может работать одновременно.

MCI_DGV_GETDEVCAPS_MAXIMUM_RATE — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится максимальная скорость вывода информации, измеряемая в кадрах в секунду.

MCI_DGV_GETDEVCAPS_MINIMUM_RATE — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится минимальная скорость вывода информации, измеряемая в кадрах в секунду.

MCI_DGV_GETDEVCAPS_PALETTES — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство может возвратить дескриптор палитры, и значение FALSE в противном случае.

Перечисленные ниже константы могут содержаться в переменной dwItem объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms для устройств типа vcr:

MCI_GETDEVCAPS_CLOCK_INCREMENT_RATE — в переменной dwReturn oбъекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится число приращений в секунду.

MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно определить длину носителя, и значение FALSE в противном случае.

MCI_VCR_GETDEVCAPS_CAN_FREEZE — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно отображать информацию в режиме паузы, и значение FALSE в противном случае.

MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно просматривать источники информации, и значение FALSE в противном случае.

MCI_VCR_GETDEVCAPS_CAN_PREROLL — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно корректировать пробег ленты при начале записи или воспроизведения, и значение FALSE в противном случае.

MCI_VCR_GETDEVCAPS_CAN_PREVIEW — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно осуществлять предварительный просмотр информации, и значение FALSE в противном случае.

MCI_VCR_GETDEVCAPS_CAN_REVERSE — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно осуществлять вывод информации в обратном направлении, и значение FALSE в противном случае.

MCI_VCR_GETDEVCAPS_CAN_TEST — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно осуществлять проверку, и значение FALSE в противном случае.

MCI_VCR_GETDEVCAPS_HAS_CLOCK — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно работать с внешним таймером, и значение FALSE в противном случае.

MCI_VCR_GETDEVCAPS_HAS_TIMECODE — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство имеет возможность работы с кодами времени или если об этой возможности отсутствует информация, и значение FALSE в противном случае.

MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится число меток (99).

MCI_VCR_GETDEVCAPS_SEEK_ACCURACY — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, определяет точность поиска информации на устройстве.

Перечисленные ниже константы могут содержаться в переменной dwItem объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms для устройств типа overlay:

MCI_OVLY_GETDEVCAPS_CAN_FREEZE — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно отображать информацию в режиме паузы, и значение FALSE в противном случае.

MCI_OVLY_GETDEVCAPS_CAN_STRETCH — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если устройство способно растягивать изображение таким образом, чтобы оно полностью заполняло кадр, и значение FALSE в противном случае.

MCI_OVLY_GETDEVCAPS_MAX_WINDOWS — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится максимальное число окон с которыми устройство может работать одновременно.

Перечисленные ниже константы могут содержаться в переменной dwItem объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms для устройств типа videodisc:

MCI_VD_GETDEVCAPS_CAN_REVERSE — переменная dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, принимает значение TRUE, если видеодиск способен воспроизводить информацию в обратном направлении, и значение FALSE в противном случае. Выводить информацию в обратном направлении могут некоторые диски CLV и диски CAV.

MCI_VD_GETDEVCAPS_CAV — в комбинации с другими флагами определяет, что возвращаемая информация относится к видеодискам формата CAV. Этот флаг устанавливается по умолчанию, если в устройстве отсутствует видеодиск.

MCI_VD_GETDEVCAPS_CLV — в комбинации с другими флагами определяет, что возвращаемая информация относится к видеодискам формата CLV.

MCI_VD_GETDEVCAPS_FAST_RATE — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится стандартная скорость ускоренного воспроизведения, измеряемая в кадрах в секунду.

MCI_VD_GETDEVCAPS_NORMAL_RATE — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится стандартная скорость нормального воспроизведения, измеряемая в кадрах в секунду.

MCI_VD_GETDEVCAPS_SLOW_RATE — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится стандартная скорость замедленного воспроизведения, измеряемая в кадрах в секунду.

Перечисленные ниже константы могут содержаться в переменной dwItem объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms для устройств типа waveaudio:

MCI_WAVE_GETDEVCAPS_INPUT — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится общее число устройства ввода (записи) аудио информации.

MCI_WAVE_GETDEVCAPS_OUTPUT — в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms, содержится общее число устройства вывода (воспроизведения) аудио информации.

0. lpCapsParms — указатель на объект структуры MCI_GETDEVCAPS_PARMS.

Примечание

Команда MCI_GETDEVCAPS позволяет получить статическую информацию об устройстве MCI. Данная команда может посылаться всем устройствам. Набор флагов данной команды зависит от конкретного устройства, информацию о котором следует получить.

Информация возвращается в переменной dwReturn объекта структуры MCI_GETDEVCAPS_PARMS, на который указывает аргумент lpCapsParms.

Описание данного сообщения содержится в файле заголовка mmsystem.h.