IMDSPDeviceControl::Seek
.gif "banner art") |
The Seek method seeks to a position that is used as the starting point by the Play or Record methods.
Syntax
HRESULT Seek(UINTfuMode,intnOffset);
Parameters
fuMode
[in] Mode for the seek operation being performed. The fuMode parameter must be one of the following modes.
| Mode | Description |
| MDSP_SEEK_BOF | Seek to a position that is nOffset units after the beginning of the file. |
| MDSP_SEEK_CUR | Seek to a position that is nOffset units from the current position. |
| MDSP_SEEK_EOF | Seek to a position that is nOffset units before the end of the file. |
nOffset
[in] Number of units by which the seek operation moves the starting position away from the origin specified by fuMode. The units of nOffset are defined by the content. They can be milliseconds for music, pages for electronic books, and so on.
A positive value for nOffset indicates seeking forward through the file. A negative value indicates seeking backward through the file. Any combination of nOffset and fuMode that indicates seeking to a position before the beginning of the file or after the end of the file is not valid, and causes the method to return E_INVALIDARG.
Return Values
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
| S_OK | The method succeeded. |
| E_INVALIDARG | One or more parameters are invalid. |
| WMDM_E_NOTSUPPORTED | Seek is not implemented on this device. |
| E_FAIL | An unspecified error occurred. |
Remarks
The seek position is defined by passing either an IWMDMStorage interface pointing to a location on a storage medium of the device, or an IWMDMOperation interface that has been implemented to support streaming audio. The IMDSPObjectInfo interface can also be passed to describe some point within the object to which the specified interface points.
For device playback, if Seek is not called before Play, then playback starts at the first audio track on the first storage medium on the media device.
For device recording, if Seek is not called before Record, the record operation fails. After the Record method is called, subsequent calls to the IMDSPObjectInfo::GetLastPlayPosition method report the total play length at any time, and equal the value returned from IMDSPObjectInfo::GetTotalLength. The recording length can be limited by calling the IMDSPObjectInfo::SetPlayLength method after returning from the Seek call.
Requirements
Header: Defined in mswmdm.h.
Library: mssachlp.lib
See Also