In This Topic ▼

IltmmCapture::GetSubObject

Summary

Retrieves the specified graph object.

Syntax

#include "ltmm.h"

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

Parameters

IltmmCapture *pCapture

Pointer to an IltmmCapture interface.

long ObjType

Value that indicates the graph object to retrieve. This must be one of the ltmmCapture_Object constants.

IUnknown **ppObject

Pointer to a variable that receives a the object's interface pointer.

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

If the function succeeds, the user should release the returned interface pointer by calling the interfaces 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 VARIANT_TRUE and then retrieving the objects using IltmmTargetFormat::GetCacheObject.