ISharedBitmap interface (thumbcache.h)

Exposes memory-efficient methods for accessing bitmaps. This interface is used as a thin wrapper around HBITMAP objects, allowing those objects to be reference counted and protected from having their underlying data changed.

Inheritance

The ISharedBitmap interface inherits from the IUnknown interface. ISharedBitmap also has these types of members:

Methods

The ISharedBitmap interface has these methods.

ISharedBitmap::Detach Retrieves the bitmap contained in an ISharedBitmap object, and returns a copy if the contained bitmap resides in shared memory.
ISharedBitmap::GetFormat Retrieves the alpha type of the bitmap image.
ISharedBitmap::GetSharedBitmap Retrieves the bitmap contained in an ISharedBitmap object.
ISharedBitmap::GetSize Retrieves the size of the bitmap contained in an ISharedBitmap object.
ISharedBitmap::InitializeBitmap Initializes a new ISharedBitmap object with a given bitmap.

Remarks

This interface is used in conjunction with the methods of IThumbnailCache. Bitmaps returned by IThumbnailCache::GetThumbnail and IThumbnailCache::GetThumbnailByID are of type ISharedBitmap.

When an ISharedBitmap object is retrieved from the thumbnail cache, the underlying bitmap may reside in shared memory to provide improved performance.

The underlying data of the memory-mapped bitmap is protected while the client is accessing it.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	thumbcache.h