MCI_SEEK 命令

MCI_SEEK 命令会尽快更改内容的当前位置。 视频和音频输出在搜寻过程中处于禁用状态。 搜寻完成后,设备将停止。 CD 音频、数字视频、MIDI 序列器、VCR、视频磁盘和波形音频设备可识别此命令。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SEEK, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SEEK_PARMS) lpSeek
);

parameters

wDeviceID

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

dwFlags

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

lpSeek

指向 MCI_SEEK_PARMS 结构的指针。 具有扩展命令集 (设备可能会将此结构替换为特定于设备的结构。)

返回值

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

备注

如果设备的数据样本大小大于 1 字节 ((例如波形音频立体声数据) ),则当指定位置与样本开始不一致时,此命令将移动到最接近样本的开头。

以下附加标志适用于支持MCI_SEEK的所有设备:

MCI_SEEK_TO_END

查找内容末尾。

MCI_SEEK_TO_START

查找内容的开头。

MCI_TO

位置包含在由 lpSeek 标识的结构的 dwTo 成员中。 分配给位置值的单位是使用 MCI_SET 命令的 MCI_SET_TIME_FORMAT 标志指定的。 请勿将此标志用于MCI_SEEK_TO_END或MCI_SEEK_TO_START。

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

MCI_VCR_SEEK_AT

由 lpSeek 标识的结构的 dwAt 成员包含整个命令开始的时间。

MCI_VCR_SEEK_MARK

由 lpSeek 标识的结构的 dwMark 成员包含要搜索的编号标记。

MCI_VCR_SEEK_REVERSE

寻道方向是反向的;这仅与 MCI_VCR_SEEK_MARK 标志一起使用。

对于 VCR 设备, lpSeek 参数指向 MCI_VCR_SEEK_PARMS 结构。

以下附加标志用于 视频磁盘 设备类型:

MCI_VD_SEEK_REVERSE

寻道方向是反向的。

要求

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

请参阅

Mci

MCI 命令