IMFStreamSink::PlaceMarker method (mfidl.h)

Article
10/13/2021

Places a marker in the stream.

Syntax

HRESULT PlaceMarker(
  [in] MFSTREAMSINK_MARKER_TYPE eMarkerType,
  [in] const PROPVARIANT        *pvarMarkerValue,
  [in] const PROPVARIANT        *pvarContextValue
);

Parameters

[in] eMarkerType

Specifies the marker type, as a member of the MFSTREAMSINK_MARKER_TYPE enumeration.

[in] pvarMarkerValue

Optional pointer to a PROPVARIANT that contains additional information related to the marker. The meaning of this value depends on the marker type. This parameter can be NULL.

[in] pvarContextValue

Optional pointer to a PROPVARIANT that is attached to the MEStreamSinkMarker event. Call IMFMediaEvent::GetValue to get this value from the event. The caller can use this information for any purpose. This parameter can be NULL.

Return value

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

Return code	Description
S_OK	The method succeeded.
MF_E_SHUTDOWN	The media sink's Shutdown method has been called.
MF_E_STREAMSINK_REMOVED	This stream was removed from the media sink and is no longer valid.

Remarks

This method causes the stream sink to send an MEStreamSinkMarker event after the stream sink consumes all of the samples that were delivered up to this point (before the call to PlaceMarker).

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	mfidl.h
Library	Mfuuid.lib