Microsoft DirectX 9.0

IDirectDrawSurface::GetBltStatus

The GetBltStatus method returns the blitter status.

Syntax

HRESULT GetBltStatus(
  DWORD dwFlags
  );

Parameters

dwFlags

One of the following values.

Value Description
DDGBS_CANBLT Query whether a blit involving this surface can occur now. The method returns DD_OK if the blit can be completed.
DDGBS_ISBLTDONE Query whether the blit is done. The method returns DD_OK if the last blit on this surface has completed.

Return Values

Value Description
DD_OK The method succeeded and a blitter is present
DDERR_INVALIDPARAMS One or more of the input parameters is invalid.
DDERR_INVALIDOBJECT DirectDraw received a pointer that was an invalid DirectDraw object.
DDERR_SURFACELOST Access to this surface is being refused because the surface memory is gone. The DirectDrawSurface object representing this surface should have Restore called on it.
DDERR_SURFACEBUSY Access to this surface is being refused because the surface is already locked by another thread.
DDERR_UNSUPPORTED Action not supported.
DDERR_WASSTILLDRAWING Informs DirectDraw that the previous Blt which is transfering information to or from this Surface is incomplete.
DDERR_NOBLTHW No blitter hardware present.

See Also