IltmmSampleSource::GetSampleBuffer

#include "ltmm.h"

C Syntax	HRESULT IltmmSampleSource_getSampleBuffer(pSampleSource, TimeOut, MediaSample)
C++ Syntax	HRESULT GetSampleBuffer(TimeOut, MediaSample)

IltmmSampleSource *pSampleSource;	pointer to an interface
long TimeOut;	time allowed to wait for buffer
IltmmMediaSampleDisp **MediaSample;	pointer to a pointer

Retrieves an unused sample buffer.

Parameter	Description
pSampleSource	Pointer to an IltmmSampleSource interface that references the sample source object that is getting the sample buffer.
TimeOut	Maximum time to wait for a free sample buffer, in milliseconds.
MediaSample	Pointer to a variable to be updated with a pointer to an IltmmMediaSampleDisp interface. This interface references the new media sample buffer.

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

The buffer retrieved by this function comes from a pool of buffers. There should be no assumptions made on the number of available buffers. If you get a buffer, fill it with data and then deliver it downstream, you should release the buffer before getting another. This is because there may only be one buffer available at a time.

If the Function succeeds, the caller must free the interface referenced by the MediaSample parameter by calling the interface's Release Function. Failure to release the buffer could cause further calls to IltmmSampleSource::GetSampleBuffer to fail.

If the function does not retrieve a buffer within the allotted time it will return E_FAIL. If this happens, you may have specified a small timeout and all the available buffers are currently being sent downstream.

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

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++.

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help

Multimedia Files You Must Include With Your Application (Redistributables)

Frequently Asked Questions

LEADTOOLS Multimedia Features

Add-on Modules

Programming with LEADTOOLS Multimedia

Appendix

LEADTOOLS Licensing

Elements:	IltmmSampleSource::SetMediaType, IltmmSampleSource::DeliverEndOfStream, IltmmSampleSource::DeliverSample, IltmmSampleSource::GetMediaType
Topics:	Multimedia Function Groups
	Using the ltmmSampleSource Object