IDirectDrawSurface7::GetBltStatus

The IDirectDrawSurface7::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, a blitter is present, and the return value is DD_OK.

If it fails, the method returns DDERR_WASSTILLDRAWING if the blitter is busy, DDERR_NOBLTHW if there is no blitter, or one of the following error values:

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Header: Declared in ddraw.h.