|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.|
When you copy pixels to a surface using either IDirectDrawSurface5::Bltor IDirectDrawSurface5::BltFast, the method might fail with DDERR_WASSTILLDRAWINGbecause the hardware blitter was not ready to accept the command.
If your application has no urgent business to perform while waiting for the blitter to come back into a state of readiness, you can specify the DDBLT_WAIT flag in the dwFlagsparameter of Blt, or the equivalent DDBLTFAST_WAIT flag for BltFast. The flag causes the method to wait until the blit can be handed off to the blitter (or until an error other than DDERR_WASSTILLDRAWING occurs).
Bltaccepts another flag, DDBLT_ASYNC, that takes advantage of any hardware FIFO (first in, first out) queuing capabilities.
Last updated on Tuesday, May 18, 2004