In This Topic ▼

IltmmMultiStreamSource::DeliverSample

Summary

Delivers a sample "downstream" to an object; play or convert object.

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmMultiStreamSource_DeliverSample(pMultiStreamSource, Stream, TimeOut, MediaSample)
C++	HRESULT DeliverSample(Stream, TimeOut, MediaSample)

Parameters

IltmmMultiStreamSource *pMultiStreamSource

Pointer to an IltmmMultiStreamSource interface that references the sample object that is delivering the sample.

long Stream

The stream index (0-based) that indicates the stream for which we deliver the sample.

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

IltmmMediaSampleDisp *MediaSample

Pointer to an IltmmMediaSampleDisp interface that references the sample to be delivered.

Returns

Value	Meaning
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 IltmmMultiStreamSource::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.

Platforms

Win32, x64.

Example

Language	Example
C	• Concatenate two AVI files using IltmmMultiStreamSource and IltmmMultiStreamTarget
	• Replace Audio using IltmmMultiStreamSource and IltmmMultiStreamTarget
C++	• Concatenate two AVI files using IltmmMultiStreamSource and IltmmMultiStreamTarget
	• Replace Audio using IltmmMultiStreamSource and IltmmMultiStreamTarget