ISharedBitmap interface (thumbcache.h)

  • Article

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