Retrieves the specified graph object.
|C||HRESULT IltmmCapture_getSubObject(pCapture, ObjType, ppObject)|
|C++||HRESULT GetSubObject(ObjType, ppObject)|
Pointer to an IltmmCapture interface.
Value that indicates the graph object to retrieve. This must be one of the ltmmCapture_Object constants.
Pointer to a variable that receives a the object's interface pointer.
|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.|
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.
Medical Web Viewer .NET
.NET, Java, Android, and iOS/macOS Assemblies
C API/C++ Class Libraries