DWORD GetBltStatus(
PDD_GETBLTSTATUSDATA lpGetBltStatus
);
GetBltStatus queries the driver for its blt status.
Parameters
lpGetBltStatus
Pointer to a DD_GETBLTSTATUSDATA structure that contains the information required to perform the blt status query.
Return Value
GetBltStatus returns a DDHAL_DRIVER_Xxx callback code that indicates how the driver handled the call. These return codes are defined in ddrawint.h.
Comments
Accelerators do not typically multi-thread on drawing, in which case the driver should simply determine if its hardware is ready for a surface blt. The driver reports its blt status based on the flag set in the dwFlags member of lpGetBltStatus. If the driver is busy and cannot otherwise perform a blt at this time, it should set the ddRVal member to DDERR_WASSTILLDRAWING; otherwise, the driver should set ddRVal to DD_OK.