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.
| Method | Description |
|---|---|
| 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 |
|
|
IDL |
|