Share via


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

See Also

Reference

IStreamBufferCapture Interface