LEADTOOLS Multimedia API Help > LEADTOOLS Multimedia Features > Multimedia Function References > IltmmMediaSampleDisp Interface > IltmmMediaSampleDisp::get_Preroll |
#include "ltmm.h"
C Syntax |
HRESULT IltmmMediaSampleDisp_get_Preroll(pMediaSampleDisp, pVal) |
C++ Syntax |
HRESULT get_Preroll(pVal) |
IltmmMediaSampleDisp *pMediaSampleDisp; |
/* pointer to an interface */ |
VARIANT_BOOL *pVal; |
/* pointer to a variable */ |
Determines if this sample is a preroll sample. A preroll sample should not be displayed.
Parameter |
Description |
|
pMediaSampleDisp |
Pointer to an IltmmMediaSampleDisp interface. |
|
pVal |
Pointer to a variable to be updated with a value that indicates whether the sample is a preroll sample. Possible values are: |
|
|
Value |
Meaning |
|
VARIANT_TRUE |
The sample is a preroll sample. |
|
VARIANT_FALSE |
The sample is not a preroll 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
Preroll samples are processed but not displayed. They are located in the media stream before the displayable samples.
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. |
Win32, x64
See Also
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++.