IMSVidPlayback::put_CurrentPosition
| Microsoft DirectShow 9.0 |
IMSVidPlayback::put_CurrentPosition
This topic applies to Windows XP or later.
The put_CurrentPosition method seeks to a specified position in the source.
Syntax
HRESULT put_CurrentPosition( long lPosition );
Parameters
lPosition
[in] Specifies the new position. The units for this parameter are determined by the current position mode.
| Position Mode | Returned Value |
| FrameMode | Frame number |
| TenthsSecondsMode | Hundredths of seconds |
To set the position mode, call IMSVidPlayback::put_PositionMode.
Return Values
The method returns an HRESULT. Possible values include the following.
| Value | Description |
| ERROR_INVALID_STATE | The graph is not built. Call the Build or View method on the Video Control. |
| E_INVALIDARG | Invalid argument. |
| S_OK | The method succeeded. |
- Note The value ERROR_INVALID_STATE is converted to an HRESULT with the HRESULT_FROM_WIN32 macro.
Remarks
If the new position is earlier than the current position and the source cannot seek backward, the method returns E_INVALIDARG.
Call the IMSVidCtl::Build or IMSVidCtl::View method before calling this method.
Requirements
Header: Dshow.h.
Library: Quartz.dll.
See Also