IDirectDrawSurface::GetBltStatus (Compact 2013)

  • Article

3/26/2014

This method obtains the blitter status.

Syntax

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 Value

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

For more information on these error codes see DirectDraw Return Values.

Requirements

Header

ddraw.h

Library

ddraw.lib

See Also

Reference

IDirectDrawSurface
DirectDraw Reference
DirectDraw Interfaces

Other Resources

DirectDraw