команда MCI_RESTORE

  • Статья

Команда MCI_RESTORE копирует растровое изображение из файла в буфер кадров. Цифровые видеоустройства распознают эту команду. Эта команда выполняет действие, противоположное MCI_CAPTURE .

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESTORE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESTORE_PARMS) lpRestore
);

Параметры

wDeviceID

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

Dwflags

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

lpRestore

Указатель на структуру MCI_DGV_RESTORE_PARMS .

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

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

Комментарии

Реализация может распознавать различные форматы изображений, но аппаратно-независимое растровое изображение Windows (DIB) всегда принимается.

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

MCI_DGV_RESTORE_FROM

Элемент lpstrFileName структуры, определяемой lpRestore , содержит адрес буфера, содержащий имя исходного файла. Имя файла является обязательным.

MCI_DGV_RESTORE_AT

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

Требования

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

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

MCI

Команды MCI