Partager via


Bitmap and Caching Properties of IMsRdpClientAdvancedSettings (Windows Embedded CE 6.0)

1/6/2010

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

Concepts

Bitmap Cache for RDP