Export (0) Print
Expand All

ISharedBitmap interface

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.

Members

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

Methods

The ISharedBitmap interface has these methods.

MethodDescription
Detach

Retrieves the bitmap contained in an ISharedBitmap object, and returns a copy if the contained bitmap resides in shared memory. After calling this method the bitmap is no longer associated with this ISharedBitmap and you cannot call ISharedBitmap::GetSharedBitmap or ISharedBitmap::Detach on it again.

GetFormat

Retrieves the alpha type of the bitmap image.

GetSharedBitmap

Retrieves the bitmap contained in an ISharedBitmap object.

GetSize

Retrieves the size of the bitmap contained in an ISharedBitmap object.

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Thumbcache.h

IDL

Thumbcache.idl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft