Классификации команд MCI

[Функция, связанная с этой страницей, MCI, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать новый код MediaPlayer вместо MCIпо возможности. Корпорация Майкрософт предлагает, что существующий код, использующий устаревшие API, будет перезаписан для использования новых API, если это возможно.]

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

  • системные команды обрабатываются напрямую MCI, а не драйвером.
  • необходимые команды обрабатываются драйвером. Все драйверы MCI должны поддерживать необходимые команды и флаги.
  • базовые команды (или необязательные команды) используются некоторыми устройствами. Если устройство поддерживает базовую команду, она должна поддерживать определенный набор флагов для этой команды.
  • расширенные команды относятся к типу устройства или драйверу. Расширенные команды включают команды, такие как команды put (MCI_PUT) и , где команды (MCI_WHERE) для digitalvideo и наложение типов устройств и расширений для существующих команд (например, флаг "Stretch " (MCI_STATUS) для типа устройства наложения).

Хотя системные и обязательные команды являются минимальным набором команд для любого драйвера MCI, базовые и расширенные команды не поддерживаются всеми драйверами. Приложение всегда может использовать системные и обязательные команды и их флаги, но если он должен использовать базовую или расширенную команду или флаг, он должен сначала запрашивать драйвер с помощью команды возможности (MCI_GETDEVCAPS) . В следующих разделах приведены общие сведения о конкретных командах в каждой категории.

Системные команды

MCI обрабатывает следующие системные команды напрямую, а не передает их на устройства MCI.

Струна Сообщение Описание
перерыв MCI_BREAK Задает ключ останова для устройства MCI.
sysinfo MCI_SYSINFO Возвращает сведения о устройствах MCI.

 

Обязательные команды

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

Струна Сообщение Описание
возможностей MCI_GETDEVCAPS Получает возможности устройства.
закрыть MCI_CLOSE Закрывает устройство.
сведения MCI_INFO Получает текстовую информацию с устройства.
открыть MCI_OPEN Инициализирует устройство.
состояния MCI_STATUS Получает сведения о состоянии с устройства. Некоторые флаги этой команды не требуются, поэтому это также базовая команда.

 

Устройства также должны поддерживать стандартный набор флагов команд для необходимых команд.

Основные команды

В следующем списке приведены основные команды. Использование этих команд устройством MCI является необязательным.

Струна Сообщение Описание
загрузка MCI_LOAD Загружает данные из файла.
приостановить MCI_PAUSE Останавливает игру. Воспроизведение или запись можно возобновить в текущей позиции.
играть MCI_PLAY Начинает передачу выходных данных.
записи MCI_RECORD Начинает запись входных данных.
возобновление MCI_RESUME Возобновляет воспроизведение или запись на приостановленном устройстве.
сохранить MCI_SAVE Сохраняет данные в файл диска.
искать MCI_SEEK Ищет вперед или назад.
задать MCI_SET Задает состояние операционной системы устройства.
состояния СОСТОЯНИЕ MCI Получает сведения о состоянии устройства. Это также требуемая команда; так как некоторые флаги не требуются, он также указан здесь. (Необязательные элементы поддерживают устройства, использующие линейный носитель с определяемыми позициями.)
остановить MCI_STOP Останавливает игру.

 

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

Расширенные команды

Некоторые устройства MCI имеют дополнительные команды или добавляют флаги в существующие команды. Хотя некоторые расширенные команды применяются только к конкретному драйверу устройства, большинство из них применяются ко всем драйверам определенного типа устройства. Например, набор команд для типа устройства последовательностирасширяет команду (MCI_SET) для добавления форматов времени, необходимых для последовательностей MIDI.

Не следует предположить, что устройство поддерживает расширенные команды или флаги. Можно использовать команду (MCI_GETDEVCAPS) для определения того, поддерживается ли определенная функция, и приложение должно быть готово к работе с возвращаемыми значениями неподдерживаемой или неподдерживаемой функции.

Следующие расширенные команды доступны с перечисленными типами устройств.

Струна Сообщение Типы устройств Описание
настройка MCI_CONFIGURE digitalvideo Отображает диалоговое окно конфигурации.
подсказки MCI_CUE digitalvideo, waveaudio Готовится к воспроизведению или записи.
удаления MCI_DELETE waveaudio Удаляет сегмент данных из файла мультимедиа.
escape- MCI_ESCAPE videodisc Отправляет пользовательские сведения на устройство.
заморозить MCI_FREEZE покрышка Отключает получение видео в буфер кадров.
положить MCI PUT digitalvideo, наложение Определяет исходные, целевые и фреймовые окна.
реализовать MCI_REALIZE digitalvideo Указывает устройству выбрать и реализовать ее палитру в контексте отображаемого окна.
setaudio MCI_ SETAUDIO digitalvideo Задает параметры звука для видео.
setvideo MCI_ SETVIDEO digitalvideo Задает параметры видео.
сигнала MCI_SIGNAL digitalvideo Определяет указанную позицию с сигналом.
спин MCI_SPIN videodisc Запускает спиннинг диска или останавливает диск от спиннинга.
шаг MCI_STEP digitalvideo, videodisc Шаги воспроизведения одного или нескольких кадров вперед или обратно.
разморозить MCI_UNFREEZE покрышка Позволяет буферу кадра получать видеоданные.
обновления MCI_UPDATE digitalvideo Переопределяет текущий кадр в контекст устройства.
где MCI WHERE digitalvideo, наложение Получает прямоугольник, указывающий исходную, целевую или кадрную область.
окна MCI_WINDOW digitalvideo, наложение Управляет окном отображения.