IDirectDrawSurface3::GetBltStatus
The IDirectDrawSurface3::GetBltStatus method obtains the blitter status.
HRESULT GetBltStatus(
DWORD dwFlags
);
Parameters
dwFlags
One of the following flags:
| DDGBS_CANBLT | ||
| Inquires whether a blit involving this surface can occur immediately, and returns DD_OK if the blit can be completed. | ||
| DDGBS_ISBLTDONE | ||
| Inquires whether the blit is done, and returns DD_OK if the last blit on this surface has completed. | ||
Return Values
If the method succeeds, that means a blitter is present, the return value is DD_OK.
If the method fails, the return value is DDERR_WASSTILLDRAWING if the blitter is busy, DDERR_NOBLTHW if there is no blitter, or one of the following error values:
| DDERR_INVALIDOBJECT |
| DDERR_INVALIDPARAMS |
| DDERR_NOBLTHW |
| DDERR_SURFACEBUSY |
| DDERR_SURFACELOST |
| DDERR_UNSUPPORTED |
| DDERR_WASSTILLDRAWING |
QuickInfo
Windows NT: Use version 5.0 or later.
Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in ddraw.h.
Import Library: Use ddraw.lib.