Команда MCI_CAPTURE

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

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_CAPTURE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_CAPTURE_PARMS) lpCapture
);

Параметры

wDeviceID

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

Dwflags

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

lpCapture

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

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

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

Комментарии

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

MCI_DGV_CAPTURE_AS

Элемент lpstrFileName структуры, определяемой lpCapture , содержит адрес буфера, указывающий целевой путь и имя файла. (Этот флаг является обязательным.)

MCI_DGV_CAPTURE_AT

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

Требования

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

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

MCI

Команды MCI