DDHAL_GETBLTSTATUSDATA (Compact 2013)

3/26/2014

This structure returns status information for the blit and passes the information to the DirectDraw hardware abstraction layer (DDHAL) GetBltStatus callback function.

Syntax

typedef struct _DDHAL_GETBLTSTATUSDATA {
  LPDDRAWI_DIRECTDRAW_GBL lpDD;
  LPDDRAWI_DDRAWSURFACE_LCL lpDDSurface;
  DWORD dwFlags;
  HRESULT ddRVal;
} DDHAL_GETBLTSTATUSDATA;

Members

  • lpDDSurface
    Pointer to the DDRAWI_DDRAWSURFACE_LCL structure that represents the DirectDrawSurface object. For GetSysmemBltStatus calls, the driver is assured that this member points to a system memory surface.
  • dwFlags
    Blit status flags.

    The following table shows the possible flags.

    Flag

    Description

    DDGBS_CANBLT

    Queries whether a blit is currently permitted.

    DDGBS_ISBLTDONE

    Queries if the last blit has finished.

  • ddRVal
    Passes the DirectDraw return values. This member should be filled in with one of the following:

    • DD_OK
      The request completed successfully.
    • DDERR_WASSTILLDRAWING
      The previous blit operation that is transferring information to or from this surface is incomplete.

    Note

    For a complete list of the DDHAL callback return values, see DDHAL Callback Return Values.

Requirements

Header

ddrawi.h

See Also

Reference

DirectDrawSurface Structures
DDRAWI_DIRECTDRAW_GBL
DDRAWI_DDRAWSURFACE_LCL
DDHAL Callback Return Values