Microsoft Windows CE 3.0  

Sharing DirectDrawClipper Objects

This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

DirectDrawClipper objects can be shared between multiple surfaces. For example, the same DirectDrawClipper object can be set on both the front buffer and the back buffer of a flipping chain. When an application attaches a DirectDrawClipper object to a surface by using the IDirectDrawSurface5::SetClippermethod, the surface increments the reference count of that object. When the reference count of the surface reaches 0, the surface will decrement the reference count of the attached DirectDrawClipper object. In addition, if a DirectDrawClipper object is detached from a surface by calling IDirectDrawSurface5::SetClipperwith a NULL clipper interface pointer, the reference count of the surface's DirectDrawClipper object will be decremented.

Note   If IDirectDrawSurface5::SetClipperis called several times consecutively on the same surface for the same DirectDrawClipper object, the reference count for the object is incremented only once. Subsequent calls do not affect the object's reference count.

 Last updated on Tuesday, May 18, 2004

© 2004 Microsoft Corporation. All rights reserved.