In This Topic ▼

IltmmTargetFormat::ShowCacheDialog

Summary

Shows a specific property dialog for the caching filter.

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmTargetFormat_ShowCacheDialog(pTargetFormat, Dialog, hWnd)
C++	HRESULT ShowCacheDialog(Dialog, hWnd)

Parameters

IltmmTargetFormat *pTargetFormat

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

long Dialog

Value that specifies which dialog to display. Must be one of the ltmmTargetFormat_Dlg constants.

long hWnd

Value that specifies the dialog owner's window handle. Must be cast to long.

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 caching filters. It returns the value that was set using the IltmmTargetFormat::put_UserFilterCache. 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::ShowCacheDialog function 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.