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 结构的指针。 (具有扩展命令集的设备可能会将此结构替换为特定于设备的结构。)

返回值

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

注解

以下附加标志用于 digitalvideo 设备类型:

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标志指定分配给位置值的单位。 这相当于查找位置,但设备在命令后暂停。

对于 digitalvideo 设备, 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 设备类型:

MCI_WAVE_INPUT

应提示波形音频输入设备。

MCI_WAVE_OUTPUT

应提示波形音频输出设备。 如果未指定标志,则为默认标志。

要求

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

另请参阅

MCI

MCI 命令