GetBltStatus

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.