MCI_CUE 命令

MCI_CUE命令提示设备，以便以最小延迟开始播放或录制。数字视频、VCR 和波形音频设备可识别此命令。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_CUE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpCue
);

参数

wDeviceID: 要接收命令消息的 MCI 设备的设备标识符。
dwFlags: MCI_NOTIFY、MCI_WAIT，或者，对于数字视频和 VCR 设备，MCI_TEST。有关这些标志的信息，请参阅等待、通知和测试标志。
lpCue: 指向 MCI_GENERIC_PARMS 结构的指针。具有扩展命令集 (设备可能会将此结构替换为特定于设备的结构。)

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

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

MCI_DGV_CUE_INPUT: 数字视频实例应为录制做好准备。如果应用程序未保留磁盘空间，则设备会使用其默认参数保留磁盘空间。如果当前演示文稿源已是外部输入，则应用程序可以省略此标志。 (此标志对选择演示文稿 source 没有影响。)
MCI_DGV_CUE_NOSHOW: 数字视频实例应准备好播放使用命令指定的帧，而不显示该帧。指定此标志后，显示器将继续在帧缓冲区中显示图像，即使其对应的帧不是当前位置。例如，如果帧缓冲区包含帧 7 中的图像，则当使用此标志将设备提示到任何其他位置时，设备将继续显示帧 7。不带此标志且没有MCI_TO标志的后续提示命令显示当前帧。
MCI_DGV_CUE_OUTPUT: 数字视频实例应做好播放准备。如果暂停工作区，则不会进行定位。如果工作区已停止，则位置可能会更改为上一个关键帧图像。如果当前演示文稿源已是工作区，则应用程序可以省略此标志。
MCI_TO: 工作区位置包含在由 lpCue 标识的结构的 dwTo 成员中。分配给位置值的单位是使用 MCI_SET 命令的 MCI_SET_TIME_FORMAT 标志指定的。这等效于查找某个位置，但设备在命令后暂停。

对于 数字视频 设备， lpCue 参数指向 MCI_DGV_CUE_PARMS 结构。

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

MCI_FROM: lpCue 指向的结构的 dwFrom 成员包含以当前时间格式指定的起始位置。
MCI_TO: lpCue 指向的结构的 dwTo 成员包含以当前时间格式指定的结束 (暂停) 位置。
MCI_VCR_CUE_INPUT: 准备录制。
MCI_VCR_CUE_OUTPUT: 准备玩游戏。如果未指定MCI_VCR_CUE_INPUT或MCI_VCR_CUE_OUTPUT，则假定MCI_VCR_CUE_OUTPUT。
MCI_VCR_CUE_PREROLL: 将设备提示到当前位置或 dwFrom 位置减去预滚动持续时间。这将允许设备在进入录制或播放模式之前自行准备。
MCI_VCR_CUE_REVERSE: 下一个播放或录制命令的方向是反向的。

使用带有 MCI_VCR_CUE_OUTPUT 标志的 MCI_CUE 命令提示播放时，可以通过发出带有MCI_FROM、MCI_TO或MCI_VCR_PLAY_REVERSE的 MCI_PLAY 命令来取消MCI_CUE。

使用带有 MCI_VCR_CUE_INPUT 标志的 MCI_CUE 进行录制时，可以通过发出带有MCI_FROM、MCI_TO或MCI_VCR_RECORD_INITIALIZE的 MCI_RECORD 命令来取消MCI_CUE。

对于 vcr 设备， lpCue 参数指向 MCI_VCR_CUE_PARMS 结构。

以下附加标志用于 waveaudio 设备类型：

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