IMSVidPlayback::put_CurrentPosition method (segment.h)
[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]
The put_CurrentPosition method seeks to a specified position in the source.
Syntax
HRESULT put_CurrentPosition(
[in] long lPosition
);
Parameters
[in] lPosition
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 value
The method returns an HRESULT. Possible values include the following.
| Return code | Description |
|---|---|
|
The graph is not built. Call the Build or View method on the Video Control. |
|
Invalid argument. |
|
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows�XP [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | segment.h (include Msvidctl.h) |