Команда update

Команда обновления перерисовывает текущий кадр в указанный контекст устройства (DC). Цифровые видеоустройства распознают эту команду.

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

_stprintf_s(
  lpszCommand, 
  TEXT("update %s %s %s"), 
  lpszDeviceID, 
  lpszHDC, 
  lpszFlags
); 

Параметры

lpszDeviceID

Идентификатор устройства MCI. Этот идентификатор или псевдоним назначается при открытии устройства.

lpszHDC

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

Значение	Значение	Значение
digitalvideo	hdc hdc hdchdc hdc вrect	paint hdc hdc

В следующей таблице перечислены флаги, которые можно указать в параметре lpszHDC , и их значения.

Значение	Значение
hdc hdc hdc	Указывает дескриптор закрашиваемого контроллера домена.
hdc hdc hdc в rect	Задает прямоугольник обрезки относительно клиентского прямоугольника.
paint hdc hdc	Рисует контроллер домена, когда приложение получает WM_PAINT сообщение, предназначенное для контроллера домена.

Чтобы указать дескриптор контроллера домена, используйте строку "hdc", за которой следует asCII-представление дескриптора. Прямоугольник указан какX1 Y1 X2 Y2. КоординатыX1 Y1указывают верхний левый угол прямоугольника, а координатыX2 Y2— ширину и высоту.

lpszFlags

Может иметь значение "wait", "notify" или и то, и другое. Для цифровых видеоустройств также можно указать "test". Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

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

Примеры

Следующая команда обновляет все окно отображения, используемое устройством movie. Число 203 — это дескриптор контроллера домена, полученного из функции BeginPaint .

update movie hdc 203

Требования

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

MCI

Командные строки MCI