#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. |
Win32, x64
See Also
Example
For an Example, refer to Directly Accessing the Direct Show Objects.
For a C example, refer to IltmmTargetFormat::put_UseFilterCache.
For a C++ example, refer to IltmmTargetFormat::put_UseFilterCache.