Partager via

DDHAL_LOCKDATA (Windows Embedded CE 6.0)

  • Article

1/6/2010

This structure contains information necessary to do a Lock operation as defined by DirectDraw's parameter structures. This structure passes the information to the DirectDraw hardware abstraction layer (DDHAL) Lock callback function.

Syntax

typedef struct _DDHAL_LOCKDATA {
  LPDDRAWI_DIRECTDRAW_GBL lpDD;
  LPDDRAWI_DDRAWSURFACE_LCL lpDDSurface;
  BOOL bHasRect;
  RECT rArea;
  LPVOID lpSurfData;
  HRESULT ddRVal;
  DWORD dwFlags;
} DDHAL_LOCKDATA;

Members

  • bHasRect
    Specifies whether the area (rArea) is valid or not.
  • rArea
    Specifies the area being locked.
  • lpSurfData
    Pointer to a surface memory.
  • ddRVal
    Passes the DirectDraw return values.

  • dwFlags
    DDLOCK flags.

    The following table shows the possible flags.

    Flag Description

    DDLOCK_DISCARD

    Indicates that every location within a locked surface will be overwritten (with a write-only operation).

    DDLOCK_READONLY

    Specifies the surface being locked will only be read.

    DDLOCK_WAITNOTBUSY

    Waits for a previously initiated drawing operation to complete instead of returning immediately with the DDERR_WASSTILLDRAWING return value.

    If a previous drawing operation is in progress at the time of the call, this flag defers returning from the call until the surface is locked or an error occurs.

    DDLOCK_WRITEONLY

    Indicates that the surface being locked will be write-enabled.

Requirements

Header ddrawi.h
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

LPDDHALSURFCB_LOCK
DDRAWI_DIRECTDRAW_GBL
DDRAWI_DDRAWSURFACE_LCL

Concepts

DirectDrawSurface Structures