update 命令

update 命令将当前帧重新绘制到指定的设备上下文 (DC) 。 数字视频设备可识别此命令。

若要发送此命令,请使用 lpszCommand 参数集调用 mciSendString 函数,如下所示。

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

parameters

lpszDeviceID

MCI 设备的标识符。 打开设备时会分配此标识符或别名。

lpszHDC

DC 的句柄。 下表列出了可识别 更新 命令的设备类型以及每种类型使用的标志。

含义 含义
digitalvideo hdc hdc hdc hdc atrect paint hdc hdc

下表列出了可在 lpszHDC 参数中指定的标志及其含义。

含义
hdc hdc 指定要绘制的 DC 的句柄。
hdc hdc at rect 指定相对于客户端矩形的剪裁矩形。
paint hdc hdc 当应用程序收到用于 DC 的 WM_PAINT 消息时绘制 DC。

若要指定 DC 的句柄,请使用字符串“hdc”,后跟句柄的 ASCII 表示形式。 矩形指定为X1 Y1 X2 Y2。 坐标X1 Y1指定矩形的左上角,坐标X2 Y2指定宽度和高度。

lpszFlags

可以是“等待”、“通知”或两者。 对于数字视频设备,还可以指定“测试”。 有关这些标志的详细信息,请参阅 等待、通知和测试标志

返回值

如果成功,则返回零,否则返回错误。

示例

以下命令更新“电影”设备使用的整个显示窗口。 数字 203 是从 BeginPaint 函数获取的 DC 的句柄。

update movie hdc 203

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]

请参阅

Mci

MCI 命令字符串