CBFS Storage 2020 Delphi Edition

Questions / Feedback?

UseSystemCache Property

Whether the operating system's cache is used.

Syntax

property UseSystemCache: Boolean read get_UseSystemCache write set_UseSystemCache;

Default Value

true

Remarks

This property specifies whether the operating system's cache should be used. Use of the OS cache affects the speed of various vault operations; however, note that the exact effects depend on the type of operation as well as the data sizes involved.

For the CBVault component, disabling this property will cause a vault's storage file (specified by the VaultFile property) to be opened with FILE_FLAG_NO_BUFFERING (on Windows) or F_NOCACHE (on Linux/macOS). This also applies for the CBDrive component on Linux and macOS.

For the CBDrive component on Windows, a vault's storage file is always opened with FILE_FLAG_NO_BUFFERING regardless of how this property is set; disabling this property prevents the system cache from being used to cache files on the virtual drive. This may be necessary in certain situations in order to prevent BSODs. Please refer to Microsoft's File Caching article for more information about the system file cache.

Note: This property cannot be changed when Active is True, and cannot be changed within events.

Copyright (c) 2021 Callback Technologies, Inc. - All rights reserved.
CBFS Storage 2020 Delphi Edition - Version 20.0 [Build 8031]