CPosPassThru.GetCurrentPosition method
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The GetCurrentPosition method retrieves the current position, relative to the total duration of the stream. This method implements the IMediaSeeking::GetCurrentPosition method.
Syntax
HRESULT GetCurrentPosition(
LONGLONG *pCurrent
);
Parameters
-
pCurrent
-
Pointer to a variable that receives the current position, in units of the current time format.
Return value
Returns an HRESULT value. Possible values include those shown in the following table.
| Return code | Description |
|---|---|
|
Success. |
|
Method is not supported. |
|
NULL pointer argument. |
Remarks
This method calls the CPosPassThru::GetMediaTime method to retrieve the most recent position. If GetMediaTime fails, the method calls IMediaSeeking::GetCurrentPosition on the connected pin.
The GetMediaTime method fails by default in the base class. If your filter caches the current position, override GetMediaTime to return the cached value.
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|