IDirectDrawSurface5::GetBltStatus

This method obtains the blitter status.

HRESULT GetBltStatus(
  DWORD dwFlags
); 

Parameters

  • dwFlags
    The following table shows the possible flags.
    Flag Description
    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

Requirements

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddraw.h.
Link Library: Ddraw.lib.

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.