команда 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 [только классические приложения] |
| Заголовок |
|