IMFStreamSink::PlaceMarker Method

Places a marker in the stream.

Syntax

public:
HRESULT PlaceMarker(
         MFSTREAMSINK_MARKER_TYPE eMarkerType,
         const PROPVARIANT *pvarMarkerValue,
         const PROPVARIANT *pvarContextValue
)

Parameters

eMarkerType
Type: MFSTREAMSINK_MARKER_TYPE

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

pvarMarkerValue
Type: PROPVARIANT *

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

pvarContextValue
Type: PROPVARIANT *

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

Type: HRESULT

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

Return codes

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.

Refer to Media Foundation return codes.

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

Header: Declared in mfidl.h.

Library: Use mfuuid.lib.