Export (0) Print
Expand All

IMFMediaSession::Start method

Starts the Media Session.

Syntax


HRESULT Start(
  [in]  const GUID *pguidTimeFormat,
  [in]  const PROPVARIANT *pvarStartPosition
);

Parameters

pguidTimeFormat [in]

Pointer to a GUID that specifies the time format for the pvarStartPosition parameter. This parameter can be NULL. The value NULL is equivalent to passing in GUID_NULL.

The following time format GUIDs are defined:

ValueMeaning
GUID_NULL

Presentation time. The pvarStartPosition parameter must have one of the following PROPVARIANT types.

  • VT_I8: The pvarStartPosition parameter contains the starting position in 100-nanosecond units, relative to the start of the presentation.
  • VT_EMPTY: Playback starts from the current position.

All media sources support this time format.

MF_TIME_FORMAT_SEGMENT_OFFSET

Segment offset. This time format is supported by the Sequencer Source. The starting time is an offset within a segment.

Call the MFCreateSequencerSegmentOffset function to create the PROPVARIANT value for the pvarStartPosition parameter.

MF_TIME_FORMAT_ENTRY_RELATIVE

Note  Requires Windows 7 or later.

Skip to a playlist entry. The pvarStartPosition parameter specifies the index of the playlist entry, relative to the current entry. For example, the value 2 skips forward two entries. To skip backward, pass a negative value. The PROPVARIANT type is VT_I4.

If a media source supports this time format, the IMFMediaSource::GetCharacteristics method returns one or both of the following flags:

  • MFMEDIASOURCE_CAN_SKIPFORWARD
  • MFMEDIASOURCE_CAN_SKIPBACKWARD

 

pvarStartPosition [in]

Pointer to a PROPVARIANT that specifies the starting position for playback. The meaning and data type of this parameter are indicated by the pguidTimeFormat parameter.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return codeDescription
S_OK

The method succeeded.

MF_E_INVALIDREQUEST

The operation cannot be performed in the Media Session's current state.

MF_E_SHUTDOWN

The Media Session has been shut down.

 

Remarks

When this method is called, the Media Session starts the presentation clock and begins to process media samples.

This method is asynchronous. When the method completes, the Media Session sends an MESessionStarted event.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Mfidl.h

Library

Mfuuid.lib

See also

IMFMediaSession

 

 

Community Additions

ADD
Show:
© 2014 Microsoft