IMFStreamSink::PlaceMarker method

Places a marker in the stream.

Syntax

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

Parameters

eMarkerType

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

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.

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

   
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

See Also

IMFStreamSink

Media Sinks