Bitmap and Caching Properties of IMsRdpClientAdvancedSettings
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
You can set and retrieve properties related to the size of bitmap cache files, persistent bitmap caching, and whether bitmap shadows should be used. The following table shows the properties you can set and retrieve.
| Property | Description |
|---|---|
BitmapCacheSize |
Size, in kilobytes (KB), of the bitmap cache file that is used for 8 bits-per-pixel (bpp) color settings. The maximum size for all virtual caches is 131,072 KB (128 MB). |
BitmapPersistence |
Value that specifies whether persistent bitmap caching should be used. A nonzero value enables this property and zero disables it. Persistent caching can improve performance but requires additional disk space. |
BitmapVirtualCacheSize |
Size, in kilobytes (KB), of the persistent bitmap cache file to use for 8 bits-per-pixel (bpp) color settings. The maximum size for all virtual caches is 131,072 KB (128 MB). |
BitmapVirtualCache16BppSize |
Size, in kilobytes (KB), of the bitmap cache file that is used for 16 bits-per-pixel (bpp) color settings. The maximum size for all virtual caches is 131,072 KB (128 MB). |
BitmapVirtualCache24BppSize |
Size, in kilobytes (KB), of the persistent bitmap cache file to use for the 24 bits-per-pixel (bpp) high-color settings. The maximum size for all virtual caches is 131,072 KB (128 MB). |
NumBitmapCaches |
Number of bitmap caches to use. The default value is 3, which results in optimal performance. |
PersistCacheDirectory |
Path to the directory for storage of bitmap cache files. This property is write-only. |
ScaleBitmapCachesByBPP |
Specifies whether the size of bitmap caches should be scaled by bit depth (bits per pixel). A nonzero value enables this property and zero disables it. It is recommended that you leave this property at its default value, which is enabled. |
ShadowBitmap |
Specifies whether shadow bitmaps should be used. A shadow bitmap effect applies a shadow behind a visual object at a slight offset. A shadow bitmap effect makes the UI element appear like it is lifting off the surface of the display screen. When in full-screen mode, shadow bitmaps can be used if the full-screen window size is smaller than the desktop size. Otherwise, shadow bitmaps are unavailable in full-screen mode. A nonzero value enables this property, zero disables it. Disabling this property typically improves performance but can result in artifacts when painting bitmaps on display screens. |
See Also
Reference
IMsRdpClientAdvancedSettings Property Descriptions