PrimoBurner(tm) for C++  4.6
CD, DVD and Blu-ray Software Development Kit
 All Classes Namespaces Files Functions Variables Enumerations Enumerator Pages
CachePolicy Class Referenceabstract

Provides an interface for setting the cache related properties of DataDisc. More...

#include <PrimoBurnerAPI.h>

Public Member Functions

virtual bool_t cacheSmallFiles () const =0
 Gets the setting for caching of small files. More...
 
virtual void setCacheSmallFiles (bool_t cacheSmallFiles)=0
 Sets the caching of small files. More...
 
virtual void setSmallFilesCacheSize (int32_t blocks)=0
 Sets the size of the in-memory cache. More...
 
virtual void setSmallFileSizeThreshold (int32_t blocks)=0
 Sets the threshold size used to determine if a given file is a small file. More...
 
virtual int32_t smallFilesCacheSize () const =0
 Gets the size of the in-memory cache in blocks. More...
 
virtual int32_t smallFileSizeThreshold () const =0
 Gets the threshold size used to determine if a given file is a small file. More...
 

Detailed Description

Provides an interface for setting the cache related properties of DataDisc.

See Also
DataDisc::cachePolicy

Member Function Documentation

virtual bool_t cacheSmallFiles ( ) const
pure virtual

Gets the setting for caching of small files.

Returns
TRUE if small files will be cached before writing with DataDisc, FALSE otherwise.
virtual void setCacheSmallFiles ( bool_t  cacheSmallFiles)
pure virtual

Sets the caching of small files.

This is useful when you burn on-the-fly with the writeToDisc method. When burning DVDs caching should be turned off. By default if you do not call this method, files are not cached before burning.

Parameters
cacheSmallFilesIndicates whether the small files should be cached before burning. If this parameter is TRUE, the caching is on. If this parameter is FALSE, the caching is turned off. The default value is FALSE.

NOTE: Caching is not done if the data source is not a file. See the DataFile class and the DataSource enumeration for more details.

virtual void setSmallFilesCacheSize ( int32_t  blocks)
pure virtual

Sets the size of the in-memory cache.

Cache is useful when you burn on-the-fly with the writeToDisc method and you want to minimize the disc activity. The default cache size is 20000 blocks (~ 40MB).

Parameters
blocksThe size of the cache in blocks. The size of one block is 2048 bytes.
See Also
setSmallFilesCache
virtual void setSmallFileSizeThreshold ( int32_t  blocks)
pure virtual

Sets the threshold size used to determine if a given file is a small file.

Parameters
blocksThe size of the threshold in blocks. The size of one block is 2048 bytes. Every file with a size smaller than blocks will be considered a small file and will be placed in the DataDisc memory cache. The default threshold size is 10 blocks (~ 20KB).
See Also
setSmallFilesCache
virtual int32_t smallFilesCacheSize ( ) const
pure virtual

Gets the size of the in-memory cache in blocks.

Returns
number of blocks
virtual int32_t smallFileSizeThreshold ( ) const
pure virtual

Gets the threshold size used to determine if a given file is a small file.

Returns
threshold size in blocks