play 命令

  • 项目

play 命令开始播放设备。 CD 音频、数字视频、MIDI 排序器、videodisc、VCR 和波形音频设备可识别此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("play %s %s %s"), 
  lpszDeviceID, 
  lpszPlayFlags, 
  lpszFlags
);

parameters

lpszDeviceID

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

lpszPlayFlags

用于播放设备的标志。 下表列出了可识别 play 命令的设备类型以及每种类型使用的标志。

值 含义 含义
cdaudio from position 到 位置
digitalvideo 从 位置全屏重复 反向定位窗口
sequencer from position 到 位置
录像机 时间从位置反向 扫描到 位置
videodisc 快速从 位置反向扫描 慢速 整数到 位置
waveaudio from position 到 位置

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

值 含义
时间 指示设备应何时开始执行此命令;如果设备已被提示，则指示何时开始执行提示命令。 有关详细信息，请参阅 提示 命令。
fast 指示设备播放速度应比平常快。 若要确定视频磁盘播放器的确切速度，请使用 状态 命令的“速度”标志。 若要更精确地指定速度，请使用此命令的“速度”标志。
from position 指定播放的起始位置。 如果未指定“from”标志，则从当前位置开始播放。 对于 cdaudio 设备，如果“from”位置大于光盘的结束位置，或者“from”位置大于“to”位置，驱动程序将返回错误。 对于 视频磁盘 设备，CAV 光盘的默认位置以帧为单位，CLV 光盘的默认位置以小时、分钟和秒为单位。
全屏 指定应使用全屏显示。 仅在播放压缩文件时使用此标志。 (未压缩的文件不会全屏播放。)
repeat 指定在到达内容末尾时应重启播放。
reverse 指定播放方向向后。 不能使用“reverse”标志指定结束位置。 对于 videodiscs，“scan”仅适用于 CAV 格式。
scan 尽可能快地播放，但不禁用视频 (尽管音频可能在) 禁用。 对于 videodiscs，“scan”仅适用于 CAV 格式。
slow 播放缓慢。 若要确定视频磁盘播放器的确切速度，请使用 状态 命令的“速度”标志。 若要更精确地指定速度，请使用此命令的“速度”标志。 对于 videodiscs，“慢速”仅适用于 CAV 格式。
速度 整数 以指定的速度（以帧/秒为单位）播放视频磁盘。 此标志仅适用于 CAV 光盘。
到 位置 指定播放的结束位置。 如果未指定“to”标志，播放会在内容末尾停止。 对于 cdaudio 设备，如果“to”位置大于光盘的结束位置，驱动程序将返回错误。 对于 视频磁盘 设备，CAV 光盘的默认位置以帧为单位，CLV 光盘的默认位置以小时、分钟和秒为单位。
window 指定播放应使用与设备实例关联的窗口。 这是默认设置。

lpszFlags

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

返回值

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

备注

在发出使用位置值的命令之前，应使用 set 命令设置所需的时间格式。 此命令开始以当前速度播放，如设置的“速度”命令设置的那样。 如果指定了“反向”标志，或者将“to”标志指定为小于“from”标志的值，则方向为反向。 如果未指定“from”标志，则从当前位置开始播放。 “to”和“reverse”标志不能一起使用。

示例

以下命令从位置 1000 到位置 2000 播放“mysound”设备，在播放完成时发送通知消息。

play mysound from 1000 to 2000 notify

要求

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

请参阅

Mci

MCI 命令字符串

提示

set