MCI_FREEZE 命令

MCI_FREEZE命令冻结屏幕上的运动。 数字视频、视频覆盖和 VCR 设备可识别此命令。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_FREEZE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpFreeze
);

parameters

wDeviceID

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

dwFlags

MCI_NOTIFY、MCI_WAIT，或者，对于数字视频和 VCR 设备，MCI_TEST。 有关这些标志的信息，请参阅 等待、通知和测试标志。

lpFreeze

指向 MCI_GENERIC_PARMS 结构的指针。 具有附加参数 (设备可能会将此结构替换为特定于设备的结构。)

返回值

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

备注

数字视频设备类型使用以下附加标志：

MCI_DGV_FREEZE_AT

由 lpFreeze 标识的 结构的 rc 成员包含有效的矩形。 矩形指定帧缓冲区中的一个区域，该区域将打开每个像素的锁掩码位。 指定的像素在锁定掩码位关闭之前不会更新。 如果未指定此标志，则矩形默认为整个帧缓冲区。 仅当MCI_GETDEVCAPS命令对 MCI_DGV_GETDEVCAPS_CAN_LOCK 标志返回 TRUE 时，才支持此标志。

MCI_DGV_FREEZE_OUTSIDE

为MCI_DGV_FREEZE_AT标志指定的区域外的区域处于冻结状态。

对于数字视频设备， lpFreeze 参数指向 MCI_DGV_FREEZE_PARMS 结构。

vcr 设备类型使用以下附加标志：

MCI_VCR_FREEZE_FIELD

仅冻结当前帧的一个成员。

MCI_VCR_FREEZE_FRAME

冻结当前帧的两个字段。

MCI_VCR_FREEZE_INPUT

冻结屏幕上的当前帧 (用于录制) 。

MCI_VCR_FREEZE_OUTPUT

冻结与帧捕获) 一起使用的 VCR (的当前帧。

对于 VCR 设备， lpFreeze 参数指向 MCI_GENERIC_PARMS 结构。

覆盖设备类型使用以下附加标志：

MCI_OVLY_RECT

由 lpFreeze 标识的 结构的 rc 成员包含有效的矩形。 如果未指定此标志，设备驱动程序将冻结整个帧。

对于视频覆盖设备， lpFreeze 参数指向 MCI_OVLY_RECT_PARMS 结构。

要求

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

另请参阅

Mci

MCI 命令