Mci_index

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_INDEX, DWORD dwFlags, (DWORD) (LPMCI_GENERIC_PARMS) lpIndex);

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

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

Аргументы

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

1. dwFlags — Флаги сообщения. Могут быть установлены флаги MCI_NOTIFY, MCI_WAIT или MCI_TEST.

2. Данные флаги могут использоваться устройствами типа vcr:

• MCI_SET_OFF — запрещает вывод на экран.

• MCI_SET_ON — разрешает вывод на экран.

0. lpIndex — указатель на объект структуры MCI_GENERIC_PARMS. (Устройства, имеющие расширенный набор команд, используют вместо этой структуры собственные структуры.)

Примечание

Команда MCI_INDEX разрешает или запрещает вывод на экран. Данная команда может посылаться видеомагнитофонам.

Информация, выводимая на экран определяется флагом MCI_VCR_SET_INDEX команды MCI_SET.

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

Mci_open

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_OPEN, DWORD dwFlags, (DWORD) (LPMCI_OPEN_PARMS) lpOpen);

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

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

Аргументы

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

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

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

• MCI_OPEN_ALIAS — в переменной lpstrAlias объекта структуры MCI_OPEN_PARMS на который указывает аргумент lpOpen, содержится альтернативное имя устройства.

• MCI_OPEN_SHAREABLE — устройство или файл могут быть открыты как разделяемый ресурс.

• MCI_OPEN_TYPE — в переменной lpstrDeviceType объекта структуры MCI_OPEN_PARMS на который указывает аргумент lpOpen, содержится имя устройства или константа.

• MCI_OPEN_TYPE_ID — в младшем слове переменной lpstrDeviceType объекта структуры MCI_OPEN_PARMS на который указывает аргумент lpOpen, содержится идентификатор стандартного типа устройства MCI, а в старшем слове этой переменной может содержаться порядковый индекс устройства. Этот флаг используется совместно с флагом MCI_OPEN_TYPE.

0. Данные флаги могут использоваться составными устройствами:

• MCI_OPEN_ELEMENT — в переменной lpstrElementName объекта структуры MCI_OPEN_PARMS на который указывает аргумент lpOpen, содержится имя файла.

• MCI_OPEN_ELEMENT_ID — переменная lpstrElementName объекта структуры MCI_OPEN_PARMS на который указывает аргумент lpOpen, рассматривается как величина, имеющая формат двойного слова, назначение которой зависит от конкретного устройства. Этот флаг устанавливается совместно с флагом MCI_OPEN_ELEMENT.

0. Данные флаги могут использоваться устройствами воспроизведения цифровой видеоинформации (устройства типа digitalvideo):

• MCI_DGV_OPEN_NOSTATIC — устройство должно уменьшить число статических (системных) цветов в палитре. Этот флаг устанавливается только для устройств, разделяющих палитру с Windows.

• MCI_DGV_OPEN_PARENT — в переменной hWndParent объекта структуры MCI_DGV_OPEN_PARMS на который указывает аргумент lpOpen, содержится дескриптор родительского окна.

• MCI_DGV_OPEN_WS — в переменной dwStyle объекта структуры MCI_DGV_OPEN_PARMS на который указывает аргумент lpOpen, содержатся стили окна.

• MCI_DGV_OPEN_16BIT — указывает на предпочтительное использование 16-битных интерфейсов.

• MCI_DGV_OPEN_32BIT — — указывает на предпочтительное использование 32-битных интерфейсов.

0. Данные флаги могут использоваться устройствами типа overlay:

• MCI_OVLY_OPEN_PARENT — в переменной hWndParent объекта структуры MCI_OVLY_OPEN_PARMS на который указывает аргумент lpOpen, содержится дескриптор родительского окна.

• MCI_OVLY_OPEN_WS — в переменной dwStyle объекта структуры MCI_OVLY_OPEN_PARMS на который указывает аргумент lpOpen, содержатся стили окна. Значение переменой dwStyle определяет стиль окна, которое создаст и выведет на экран драйвер устройства, если в нем не указаны стили создаваемого окна. Стили окна, содержащиеся в целочисленной величине, представляют собой комбинацию стандартных типов окна (таких, как WS_CHILD, WS_OVERLAPPEDWINDOW или WS_POPUP).

0. Данные флаги могут использоваться устройствами типа waveaudio:

• MCI_WAVE_OPEN_BUFFER — в переменной dwBufferSeconds объекта структуры MCI_WAVE_OPEN_PARMS на который указывает аргумент lpOpen, содержится длина буфера в секундах.

0. lpOpen — указатель на объект структуры MCI_OPEN_PARMS. (Устройства, имеющие расширенный набор команд, используют вместо этой структуры собственные структуры.)

Примечание

Команда MCI_OPEN инициализирует устройство или файл. Эту команду можно посылать любому устройству.

При посылке этой команды в функции mciSendCommand следует установить флаг MCI_OPEN_TYPE. Если при открытии устройства используется константа типа устройства, то наряду с флагом MCI_OPEN_TYPE следует установить флаг MCI_OPEN_TYPE_ID.

Если при открытии устройства или файла не был установлен флаг MCI_OPEN_SHAREABLE, все последующие посылки команды MCI_OPEN будут завершаться с ошибкой даже в том случае, если при первом открытии данного устройства или файла был установлен флаг MCI_OPEN_SHAREABLE. Файлы, открытые для устройств, использующих драйверы mciseq.drv и mciwave.drv, не могут разделяться с другими устройствами.

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

Для автоматического определения типа (с использованием системного реестра), в переменную lpstrElementName объекта структуры MCI_OPEN_PARMS на который указывает аргумент lpOpen, заносится имя и расширение файла, в переменную lpstrDeviceType заносится нулевое значение и в сообщении устанавливается флаг MCI_OPEN_ELEMENT.

При работе с устройством вывода видео информации в переменной lpOpen передаётся указатель на объект структуры MCI_DGV_OPEN_PARMS, при работе с устройством наложения видеоинформации — указатель на объект структуры MCI_OVLY_OPEN_PARMS, а при работе с устройства вывода аудио информации в формате ИКМ — MCI_WAVE_OPEN_PARMS. При этом следует учесть, что драйвер MCIWAVE работает только с асинхронными аудио устройствами.

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