Edit

Share via

AM_SEEKING_SEEKING_CAPABILITIES enumeration (strmif.h)

  • Article

[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.]

Specifies the seeking capabilities of a media stream.

Syntax

typedef enum AM_SEEKING_SeekingCapabilities {
  AM_SEEKING_CanSeekAbsolute = 0x1,
  AM_SEEKING_CanSeekForwards = 0x2,
  AM_SEEKING_CanSeekBackwards = 0x4,
  AM_SEEKING_CanGetCurrentPos = 0x8,
  AM_SEEKING_CanGetStopPos = 0x10,
  AM_SEEKING_CanGetDuration = 0x20,
  AM_SEEKING_CanPlayBackwards = 0x40,
  AM_SEEKING_CanDoSegments = 0x80,
  AM_SEEKING_Source = 0x100
} AM_SEEKING_SEEKING_CAPABILITIES;

Constants

 
AM_SEEKING_CanSeekAbsolute
Value: 0x1
The stream can seek to an absolute position.
AM_SEEKING_CanSeekForwards
Value: 0x2
The stream can seek forward.
AM_SEEKING_CanSeekBackwards
Value: 0x4
The stream can seek backward.
AM_SEEKING_CanGetCurrentPos
Value: 0x8
The stream can report its current position. See Remarks.
AM_SEEKING_CanGetStopPos
Value: 0x10
The stream can report its stop position.
AM_SEEKING_CanGetDuration
Value: 0x20
The stream can report its duration.
AM_SEEKING_CanPlayBackwards
Value: 0x40
The stream can play backward.
AM_SEEKING_CanDoSegments
Value: 0x80
The stream can do seamless looping (see IMediaSeeking::SetPositions).
AM_SEEKING_Source
Value: 0x100
Reserved.

Remarks

Most DirectShow filters do not report the AM_SEEKING_CanGetCurrentPos capability flag. However, the Filter Graph Manager's implementation of IMediaSeeking::GetCurrentPosition is based on the reference clock, so you can call this method even if the capabilities flags do not include AM_SEEKING_CanGetCurrentPos.

Requirements

Requirement Value
Header strmif.h (include Dshow.h)

See also

DirectShow Enumerated Types

IMediaSeeking::CheckCapabilities

IMediaSeeking::GetCapabilities