IWMDMDeviceControl::Seek 方法 (mswmdm.h)
Seek方法會搜尋作為Play或Record方法起點的位置。
語法
HRESULT Seek(
[in] UINT fuMode,
[in] int nOffset
);
參數
[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。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
一或多個參數無效。 |
|
此裝置上未實作 Seek。 |
|
發生未指定的錯誤。 |
備註
搜尋位置的定義方式是傳遞指向裝置儲存媒體上位置的 IWMDMStorage 介面,或已實作以支援串流音訊的 IWMDMOperation 介面。 也可以傳遞 IWMDMObjectInfo介面,以描述指定介面所指向之物件內的一些點。
針對裝置播放,如果在播放之前未呼叫Seek,則播放會從媒體裝置上第一個儲存媒體上的第一個音訊播放軌開始。
針對裝置錄製,如果未在Record之前呼叫Seek,則記錄作業會失敗。 從Seek呼叫之後,呼叫IWMDMObjectInfo::SetPlayLength方法可以限制錄製長度。
需求
目標平台 | Windows |
標頭 | mswmdm.h |
程式庫 | Mssachlp.lib |