FileCache Property

Which file data cache implementation to use.

Syntax

ANSI (Cross Platform)
int GetFileCache();
int SetFileCache(int iFileCache);

Unicode (Windows)
INT GetFileCache();
INT SetFileCache(INT iFileCache);

Possible Values

FC_NONE(0), 
FC_SYSTEM(1), 
FC_INTERNAL_KERNEL_MODE(2), 
FC_INTERNAL_USER_MODE(3)

#define PID_CBFS_FILECACHE 12

CBFSCONNECT_EXTERNAL void* CBFSCONNECT_CALL CBFSConnect_CBFS_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
CBFSCONNECT_EXTERNAL int CBFSCONNECT_CALL CBFSConnect_CBFS_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);

Default Value

Remarks

This property specifies which file data cache implementation a virtual drive should use, if any. Possible values are:

fcNone (0): Do not use file data caching.
fcSystem (1, default): Delegate file data caching to the Windows file management system cache (recommended).
fcInternalKernelMode (2): Use the CBFS kernel mode file data cache implementation.
fcInternalUserMode (3): Use the CBFS user mode file data cache implementation.

When the cache is enabled, commonly-used file data will be cached to help reduce the number of times the ReadFile and WriteFile events are fired.

When set to fcInternalUserMode (3), the UserModeFileCacheSize configuration setting can be used to control the cache size.

Please refer to the Caching topic for detailed information on each of the cache implementations.

Note: This property cannot be changed within events.

Data Type

Integer