In This Topic ▼

IltmmTargetFormat::get_UseFilterCache

Summary

Queries whether the toolkit is currently caching filters.

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmTargetFormat_get_UseFilterCache(pTargetFormat, pVal)
C++	HRESULT get_UseFilterCache(pVal)

Parameters

IltmmTargetFormat *pTargetFormat

Pointer to the IltmmTargetFormat interface that references the target format object.

VARIANT_BOOL *pVal

Pointer to a variable to be updated with a value that indicates whether the toolkit is caching filters. Possible values are:

Value	Meaning
VARIANT_TRUE	The toolkit is caching filters.
VARIANT_FALSE	The toolkit is not caching filters. This is the default value.

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

Use the IltmmTargetFormat::get_UseFilterCache function to query whether the toolkit is currently caching filters. It returns the value that was set using the IltmmTargetFormat::put_UserFilterCache function. Use the IltmmTargetFormat::put_UseFilterCache function to enable or disable caching for the target format. Use the IltmmTargetFormat::GetCacheObject function to retrieve the caching filter object. Use the IltmmTargetFormat::ShowCacheDialogfunction to display a specific property dialog for the caching filter. Use the IltmmTargetFormat::HasCacheDialog function to query whether the specified property dialog for the caching filter is available.

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.

Example

Language	Example
C	• IltmmTargetFormat::CreateTargetFormats
	• IltmmTargetFormat::put_UseFilterCache
C++	• IltmmTargetFormat::CreateTargetFormats
	• IltmmTargetFormat::put_UseFilterCache