#include "ltmm.h"
C Syntax |
HRESULT IltmmSampleSource_DeliverSample(pSampleSource, TimeOut, MediaSample) |
C++ Syntax |
HRESULT DeliverSample(TimeOut, MediaSample) |
IltmmSampleSource *pSampleSource; |
/* pointer to an interface */ |
long TimeOut; |
/* time allowed for sample delivery */ |
IltmmMediaSampleDisp *pMediaSample; |
/* pointer to an interface */ |
Delivers a sample to an object "downstream" of the Sample Source object.
Parameter |
Description |
pSampleSource |
Pointer to an IltmmSampleSource interface that references the sample object that is delivering the sample. |
TimeOut |
Maximum time to allow for sample delivery, in milliseconds. If this function "times out" then E_FAIL is returned and the sample is not delivered. |
MediaSample |
Pointer to an IltmmMediaSampleDisp interface that references the sample to be delivered. |
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
Users must only pass in samples returned from the IltmmSampleSource::GetSampleBuffer Function. Do not pass samples obtained by calling GetSampleBuffer from another interface. You should release the sample once it has been delivered, and should not attempt to make any further modifications to the sample.
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
Elements: |
IltmmSampleSource::DeliverEndOfStream, IltmmSampleSource::GetMediaType, IltmmSampleSource::GetSampleBuffer, IltmmSampleSource::SetMediaType |
Topics: |
Example
For a C example, refer to Creating an AVI File from Bitmaps Using ltmmSampleSource for C.
For a C++ example, refer to Creating an AVI File from Bitmaps Using ltmmSampleSource for C++.