MCI_RESTORE 命令

MCI_RESTORE 命令将位图从文件复制到帧缓冲区。 数字视频设备可识别此命令。 此命令执行 与 MCI_CAPTURE 命令相反的操作。

若要发送此命令,请使用以下参数调用 mciSendCommand 函数。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESTORE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESTORE_PARMS) lpRestore
);

parameters

wDeviceID

要接收命令消息的 MCI 设备的设备标识符。

dwFlags

MCI_NOTIFY、MCI_WAIT或MCI_TEST。 有关这些标志的信息,请参阅 等待、通知和测试标志

lpRestore

指向 MCI_DGV_RESTORE_PARMS 结构的指针。

返回值

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

备注

实现可以识别各种图像格式,但始终接受与 Windows 设备无关的位图 (DIB) 。

以下附加标志适用于数字视频设备:

MCI_DGV_RESTORE_FROM

lpRestore 标识的 结构的 lpstrFileName 成员包含包含源文件名的缓冲区的地址。 文件名是必需的。

MCI_DGV_RESTORE_AT

由 lpRestore 标识的 结构的 rc 成员包含有效的矩形。 矩形指定帧缓冲区相对于其原点的区域。 第一对坐标指定矩形的左上角;第二对指定宽度和高度。 如果未指定此标志,则会将图像复制到帧缓冲区的左上角。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Mmsystem.h (包括 Windows.h)

另请参阅

Mci

MCI 命令