IDirectDrawSurface::GetBltStatus

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later