通过

IWMDMDeviceControl：：Seek 方法 (mswmdm.h)

  • 项目

Seek 方法查找由 Play 或 Record 方法用作起点的位置。

语法

HRESULT Seek(
  [in] UINT fuMode,
  [in] int  nOffset
);

parameters

[in] fuMode

正在执行的查找操作的模式。 fuMode 参数必须是以下模式之一。

“模式” 说明
WMDM_SEEK_BEGIN 在文件开头之后查找 nOffset 单位的位置。
WMDM_SEEK_CURRENT 从当前位置查找 nOffset 单位的位置。
WMDM_SEEK_END 在文件末尾之前查找 nOffset 单位的位置。
WMDM_SEEK_REMOTECONTROL 查找可移动控件。
WMDM_SEEK_STREAMINGAUDIO 查找流音频。

[in] nOffset

查找操作将起始位置从 fuMode 指定的原点移开的单位数。 nOffset 的单位由内容定义。 对于音乐，它们可以是毫秒，也可以是电子书籍的页面等。

nOffset 的正值表示通过文件向前查找。 负值表示通过文件向后查找。 nOffset 和 fuMode 的任意组合，指示在文件开头之前或文件末尾之后查找某个位置无效，并导致方法返回E_INVALIDARG。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 方法成功。
E_INVALIDARG
 一个或多个参数无效。
WMDM_E_NOTSUPPORTED
 此设备上未实现 Seek。
E_FAIL
 发生了未指定的错误。

注解

通过传递指向设备存储介质上位置的 IWMDMStorage 接口或已实现以支持流音频的 IWMDMOperation 接口来定义搜寻位置。 还可以传递 IWMDMObjectInfo 接口来描述指定接口指向的对象中的某个点。

对于设备播放，如果在播放前未调用 Seek，则播放将在媒体设备上的第一个存储介质上的第一个音频轨道处开始播放。

对于设备录制，如果在记录之前未调用 Seek，则记录操作将失败。 从 Seek 调用返回后，可以通过调用 IWMDMObjectInfo：：SetPlayLength 方法来限制录制长度。

要求

   
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

请参阅

IWMDMDeviceControl 接口

IWMDMObjectInfo 接口

IWMDMOperation 接口

IWMDMStorage 接口