Blitting in Direct3D Mobile (Windows CE 5.0)
The IDirect3DMobileDevice::ColorFill and IDirect3DMobileDevice::StretchRect methods are two blitting methods available from the COM interface that exist outside of the normal rendering pipeline. These methods generate command buffer tokens, so blit operations can be performed without stalling command processing in the same way that surface locking or getting a device context would.
Microsoft® Direct3D® Mobile enforces rules about the surface types that are useable as the destination surface in a blitting operation. An application is permitted to blit to render targets, including texture render targets, and off-screen image surfaces. An application is not permitted to blit directly to the primary surface using the IDirect3DMobileDevice::ColorFill and IDirect3DMobileDevice::StretchRect methods. If your application violates these rules, the debug middleware will fail the call. The behavior in the release middleware is undefined.
You specify the rectangular regions that the blitting methods operate on by providing them with data in a RECT structure. The blitting methods do not operate on the right column and the bottom row of the rectangular region defined in the RECT structure.
See Also
Send Feedback on this topic to the authors