Команда 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

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]

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

MCI

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