IltmmCapture::GetSubObject

#include "ltmm.h"

C Syntax	HRESULT IltmmCapture_getSubObject(pCapture, ObjType, ppObject)
C++ Syntax	HRESULT GetSubObject(ObjType, ppObject)

IltmmCapture *pCapture;	/* pointer to an interface */
long ObjType;	/* object to retrieve */
IUnknown **ppObject;	/* pointer to a pointer */

Retrieves the specified graph object.

Parameter	Description
pCapture	Pointer to an IltmmCapture interface.
ObjType	Value that indicates the graph object to retrieve. This must be one of the ltmmCapture_Object constants.
ppObject	Pointer to a variable that receives a the object's interface pointer.

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

If the function succeeds, the user should release the returned interface pointer by calling the interface’s Release method.

To obtain objects (including a filter being cached) from the convert graph, use the IltmmConvert::GetSubObject function.

NOTE: This function should not be used in order to change properties on objects of type TargetFilter when the filter is multiplexer or sink. The target filters are not added to the capture graph until the capture graph being built using IltmmCapture::ReadyCapture or IltmmCapture::StartCapture. But at this point, the graph is in running state. Some multiplexers or sinks might not be able to change some settings in running mode. By default, when the capture is stopped, the multiplexer and sink are destroyed so the only way to change their settings in stopped mode is to create them before the capture starts. This can be done by first calling function IltmmTargetFormat::put_UseFilterCache with true and then retrieving the objects using IltmmTargetFormat::GetCacheObject.

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

Elements:	ltmmCapture_Object Constants, IltmmTargetFormat::get_UseFilterCache, IltmmTargetFormat::put_UseFilterCache, IltmmTargetFormat::GetCacheObject, IltmmTargetFormat::ShowCacheDialog, IltmmTargetFormat::HasCacheDialog
Topics:	Multimedia Function Group