|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.|
The IDirect3DMobileDevice::ColorFilland IDirect3DMobileDevice::StretchRectmethods 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::ColorFilland IDirect3DMobileDevice::StretchRectmethods. 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 RECTstructure. The blitting methods do not operate on the right column and the bottom row of the rectangular region defined in the RECTstructure.