The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IMFMediaSinkPreroll::NotifyPreroll method

Notifies the media sink that the presentation clock is about to start.

Syntax

C++


HRESULT NotifyPreroll(
  [in] MFTIME hnsUpcomingStartTime
);

Parameters

hnsUpcomingStartTime [in]: The upcoming start time for the presentation clock, in 100-nanosecond units. This time is the same value that will be given to the IMFPresentationClock::Start method when the presentation clock is started.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

After this method is called, the media sink sends any number of MEStreamSinkRequestSample events to request samples, until is has enough preroll data. When it has enough preroll data, the media sink sends an MEStreamSinkPrerolled event. This event signals that the client can start the presentation clock.

During preroll, the media sink can prepare the samples that it receives, so that they are ready to be rendered. It does not actually render any samples until the clock starts.

Requirements

Minimum supported client	Windows Vista [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2008 [desktop apps \| Windows Store apps]
Header	Mfidl.h
Library	Mfuuid.lib