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 [仅限桌面应用] |
标头 |
|