IltmmMediaSampleDisp::Clone

#include "ltmm.h"

C Syntax	HRESULT IltmmMediaSampleDisp_Clone(pMediaSampleDisp, ppCopy)
C++ Syntax	HRESULT Clone(ppCopy)

IltmmMediaSampleDisp *pMediaSampleDisp;	pointer to the interface
IltmmMediaSampleDisp **ppCopy;	pointer to new interface

Allocates a new IltmmMediaSampleDisp object containing a copy of the sample data and all the attributes.

Parameter	Description
pMediaSampleDisp	Pointer to the source IltmmMediaSampleDisp interface.
ppCopy	Pointer to the IltmmMediaSampleDisp interface that will contain a complete copy of the data and all the attributes.

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.

Required DLLs and Libraries

This function allows you to make a complete copy of the data and all the attributes contained in a IltmmMediaSampleDisp object. This is useful for keeping a IltmmMediaSampleDisp object for a while longer because getting multiple sample buffers will invalidate the previous buffers. For example, in this code, the second call invalidates the first sample:

void GetSamples(IltmmSampleSource *pSampleSource) 
{ 
   IltmmMediaSampleDisp *pSample1, *pSample2; 
   pSampleSource->GetSampleBuffer(1000, &pSample1); // pSample1 becomes valid 
   pSampleSource->GetSampleBuffer(1000, &pSample2); // pSample2 is valid but pSample1 is invalid 
   /* Do something with both samples */ 
}

Can be changed to something like this:

void GetSamples(IltmmSampleSource *pSampleSource) 
{ 
   IltmmMediaSampleDisp *pSample1, *pSample2; 
   pSampleSource->GetSampleBuffer(1000, &pSample2); // pSample2 becomes valid 
   pSample2->Clone(&pSample1);                      // pSample1 is valid and a full copy of pSample2 
   pSample2->Release();                             // Release pSample2. pSample1 is still valid 
   pSampleSource->GetSampleBuffer(1000, &pSample2); // pSample1 and pSample2 are both valid 
   /* Do something with both samples */ 
}

This function is similar to IltmmMediaSampleDisp::CopyTo, except that this function creates a new IltmmMediaSampleDisp interface, copies everything into it and then returns the newly created object.

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::CopyTo, 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_Preroll, IltmmMediaSampleDisp::put_SyncPoint, IltmmMediaSampleDisp::ResetMediaTime, IltmmMediaSampleDisp::ResetTime, IltmmMediaSampleDisp::SetMediaTime, IltmmMediaSampleDisp::SetMediaType, IltmmMediaSampleDisp::SetTime
Topics:	Multimedia Function Group
	IltmmMediaSampleDisp interface
	ltmmMediaSample object

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