Mci_close

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_CLOSE, DWORD dwFlags, (DWORD) (LPMCI_GENERIC_PARMS) lpClose);

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

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

Аргументы

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

1. dwFlags — Флаги MCI_NOTIFY или MCI_WAIT.

2. lpClose — указатель на объект структуры MCI_GENERIC_PARMS. (Можно использовать и объект структуры MCI_CLOSE_PARMS.)

Примечание

Команда MCI_CLOSE прекращает доступ к устройству или файлу. Данная команда может посылаться любому устройству.

Если при завершении работы приложения не будет закрыто какое-либо из открытых в нём устройств MCI, то доступ к данному устройству со стороны других приложений становится невозможен. Поэтому приложение должно явным образом закрывать открытые им файлы и устройства перед завершением своей работы. MCI закрывает устройство после того, как будут закрыты все экземпляры данного устройства или все связанные с ним файлы.

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

MCI_CUE

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_CUE, DWORD dwFlags, (DWORD) (LPMCI_GENERIC_PARMS) lpCue);

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

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

Аргументы

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

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

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

• MCI_DGV_CUE_INPUT — устройство должно подготовиться к записи видеоинформации. Если приложение не зарезервировало дисковое пространство, устройство резервирует дисковое пространство с использованием параметров, установленных по умолчанию. Приложение может не устанавливать этот флаг, если источником информации является внешнее устройство.

• MCI_DGV_CUE_NOSHOW — устройство должно подготовится к воспроизведению кадра, указанного в команде, не выводя его на экран. При установке данного флага на экране сохраняется предыдущее изображение, даже в том случае, если выводимый кадр не соответствует текущей позиции воспроизведения. При последовательном вызове команды подготовки без установки данного флага и флага MCI_TO приведёт к выводу текущего кадра.

• MCI_DGV_CUE_OUTPUT — устройство должно подготовится к воспроизведению информации. Если устройство находится в режиме паузы, то текущая позиция не изменяется. Если воспроизведение было остановлено, то текущая позиция может переместиться в предыдущую ключевую позицию. Приложение может не устанавливать этот флаг, если источник воспроизведения уже загружен в приложение.

• MCI_TO — в переменной dwTo объекта структуры MCI_DGV_CUE_PARMS, на который указывает аргумент lpCue, содержится текущая позиция воспроизведения или записи. Размерность величины, в которой задаётся начальная позиция, определяется флагом MCI_SET_TIME_FORMAT сообщения MCI_SET. Эта команда эквивалентна команде поиска, после которой устройство переходит в режим паузы.

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

• MCI_FROM — в переменной dwFrom объекта структуры MCI_VCR_CUE_PARMS, на который указывает аргумент lpCue, содержится начальная позиция, заданная в текущем временном формате.

• MCI_TO — в переменной dwTo объекта структуры MCI_VCR_CUE_PARMS, на который указывает аргумент lpCue, содержится конечная позиция (позиция паузы), заданная в текущем временном формате.

• MCI_VCR_CUE_INPUT — устройство должно подготовиться к записи информации.

• MCI_VCR_CUE_OUTPUT — устройство должно подготовиться к воспроизведению информации. Если не установлен флаг MCI_VCR_CUE_INPUT, то автоматически устанавливается флаг MCI_VCR_CUE_OUTPUT.

• MCI_VCR_CUE_PREROLL — оставляет устройство в текущей позиции, или перемещает его в позицию dwFrom минус время, необходимое для инициализации процесса записи или воспроизведения на видеомагнитофоне. Это позволяет устройству подготовится к переходу в режим записи или воспроизведения.

• MCI_VCR_CUE_REVERSE — последующая операция воспроизведения или записи будет производиться в обратном режиме.

Для отмены действия команды MCI_CUE с установленным флагом MCI_VCR_CUE_OUTPUT следует использовать команду MCI_PLAY, установив в ней флаг MCI_FROM, MCI_TO или MCI_VCR_PLAY_REVERSE.

Для отмены действия команды MCI_CUE с установленным флагом MCI_VCR_CUE_INPUT следует использовать команду MCI_RECORD, установив в ней флаг MCI_FROM, MCI_TO или MCI_VCR_RECORD_INITIALIZE.

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

• MCI_WAVE_INPUT — производится подготовка устройства ввода аудио информации.

• MCI_WAVE_OUTPUT — производится подготовка устройства вывода аудио информации. Этот флаг устанавливается по умолчанию.

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

Примечание

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

При работе с устройством вывода видео информации в переменной lpCue передаётся указатель на объект структуры MCI_DGV_CUE_PARMS, а при работе с видеомагнитофоном — объект структуры MCI_VCR_CUE_PARMS.

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