команда MCI_OPEN

  • Статья

Команда MCI_OPEN инициализирует устройство или файл. Все устройства распознают эту команду.

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

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

Параметры

wDeviceID

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

Dwflags

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

lpOpen

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

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

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

Комментарии

Флаг MCI_OPEN_TYPE должен использоваться всякий раз, когда устройство указано в функции mciSendCommand . Если вы открываете устройство, указывая константу типа устройства, в дополнение к MCI_OPEN_TYPE необходимо указать флаг MCI_OPEN_TYPE_ID. Список констант типа устройства см. в разделе Типы устройств MCI.

Если флаг MCI_OPEN_SHAREABLE не указан при первоначальном открытии устройства или файла, все последующие команды MCI_OPEN устройства или файла будут завершаться ошибкой. Если устройство или файл уже открыты и этот флаг не указан, вызов завершится ошибкой, даже если первая команда открытия, указанная MCI_OPEN_SHAREABLE. Файлы, открытые для MCISEQ. DRV и MCIWAVE. Устройства DRV недоступны для совместного использования.

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

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

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

MCI_OPEN_ALIAS

Псевдоним включен в элемент lpstrAlias структуры, определяемой lpOpen.

MCI_OPEN_SHAREABLE

Устройство или файл должны быть открыты как общие.

MCI_OPEN_TYPE

Имя или константа типа устройства включается в элемент lpstrDeviceType структуры, определяемой lpOpen.

MCI_OPEN_TYPE_ID

Слово нижнего порядка элемента lpstrDeviceType структуры, определяемой lpOpen , содержит стандартный идентификатор типа устройства MCI, а слово высокого порядка при необходимости содержит порядковый индекс устройства. Используйте этот флаг с флагом MCI_OPEN_TYPE.

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

MCI_OPEN_ELEMENT

Имя файла включается в элемент lpstrElementName структуры, определяемой lpOpen.

MCI_OPEN_ELEMENT_ID

Элемент lpstrElementName структуры, определяемой lpOpen , интерпретируется как значение DWORD и имеет внутреннее значение для устройства. Используйте этот флаг с флагом MCI_OPEN_ELEMENT.

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

MCI_DGV_OPEN_NOSTATIC

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

MCI_DGV_OPEN_PARENT

Дескриптор родительского окна указывается в элементе hWndParent структуры, определяемой lpOpen.

MCI_DGV_OPEN_WS

Стиль окна указывается в элементе dwStyle структуры, определяемой lpOpen.

MCI_DGV_OPEN_16BIT

Указывает предпочтение для поддержки 16-разрядных устройств MCI.

MCI_DGV_OPEN_32BIT

Указывает предпочтение для поддержки 32-разрядных устройств MCI.

Для цифровых видеоустройств параметр lpOpen указывает на структуру MCI_DGV_OPEN_PARMS .

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

MCI_OVLY_OPEN_PARENT

Дескриптор родительского окна указывается в элементе hWndParent структуры, определяемой lpOpen.

MCI_OVLY_OPEN_WS

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

Для устройств с наложением видео параметр lpOpen указывает на структуру MCI_OVLY_OPEN_PARMS .

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

MCI_WAVE_OPEN_BUFFER

Длина буфера указывается в элементе dwBufferSeconds структуры, определяемой lpOpen.

Для устройств waveform-audio параметр lpOpen указывает на структуру MCI_WAVE_OPEN_PARMS . Для драйвера MCIWAVE требуется асинхронное устройство waveform-audio.

Требования

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

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

MCI

Команды MCI