IStreamBufferCapture::GetCurrentPosition (Windows Embedded CE 6.0)
1/6/2010
This method reports the current position of the capture graph. Use this method to coordinate external events with a recording that is already in progress. The position reported by this method is consistent with the samples that are available for viewing by a playback graph that is bound to live TV.
Syntax
HRESULT GetCurrentPosition(
LONGLONG* phyCurrentPosition
);
Parameters
- phyCurrentPosition
[out] A pointer to a LONGLONG value that will contain the current position of the capture graph. The value is reported in units of 100 nanoseconds.
Return Value
Returns one of the following values.
| Value | Description |
|---|---|
E_NOTIMPL |
The filter graph does not support determination of the current position. |
S_OK |
The method was successful. |
Remarks
The media data up to the reported position may or may not have been stored in the recording.
If a request to start a new recording comes in, the new recording may start with a position earlier than the reported position. For example, a key frame on the primary input pin may be queued up between the media source and the file writer.
The recording may also start at a significantly later position. For example, if several seconds pass between key frames in an ASF clip, the position reported is the starting position of the most recently received media sample. Therefore, if media samples typically arrive every 400 milliseconds, the position will advance in roughly 400 millisecond jumps. Any tests for recording speed must allow for this granularity.
Requirements
| Windows Embedded CE | Windows CE 5.0 Networked Media Device Feature Pack and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment |