IltmmMediaSampleDisp::put_Preroll

#include "ltmm.h"

C Syntax

HRESULT IltmmMediaSampleDisp_put_Preroll(pMediaSampleDisp, newVal)

C++ Syntax

HRESULT put_Preroll(newVal)

 

IltmmMediaSampleDisp *pMediaSampleDisp;

/* pointer to an interface */

VARIANT_BOOL newVal;

/* flag */

Specifies whether this sample is a preroll sample.

Parameter

Description

pMediaSampleDisp

Pointer to an IltmmMediaSampleDisp interface.

newVal

Flag that indicates whether the sample represents a discontinuity in the data stream. Possible values are:

 

Value

Meaning

 

VARIANT_TRUE

The media sample is discontinuous with the previous sample.

 

VARIANT_FALSE

The media sample is not discontinuous with the previous sample.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

A preroll sample is a sample delivered prior to the selected start time.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Functions:

IltmmMediaSampleDisp::get_ActualDataLength, IltmmMediaSampleDisp::get_Buffer, IltmmMediaSampleDisp::get_BufferSize, IltmmMediaSampleDisp::get_Discontinuity, IltmmMediaSampleDisp::get_Preroll, IltmmMediaSampleDisp::get_SyncPoint, IltmmMediaSampleDisp::GetData, IltmmMediaSampleDisp::GetMediaTime, IltmmMediaSampleDisp::GetMediaType, IltmmMediaSampleDisp::GetTime, IltmmMediaSampleDisp::put_ActualDataLength, IltmmMediaSampleDisp::put_Discontinuity, IltmmMediaSampleDisp::put_SyncPoint, IltmmMediaSampleDisp::ResetMediaTime, IltmmMediaSampleDisp::ResetTime, IltmmMediaSampleDisp::SetData, IltmmMediaSampleDisp::SetMediaTime, IltmmMediaSampleDisp::SetMediaType, IltmmMediaSampleDisp::SetTime

Topics:

Multimedia Function Group

 

IltmmMediaSampleDisp interface

 

ltmmMediaSample object

Example

For a C example, refer to Copying ltmmMediaSample attributes and data for C.

For a C++ example, refer to Copying ltmmMediaSample attributes and data for C++.