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

Help Version 20.0.2019.8.26
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2019 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help