DDHAL_LOCKDATA (Windows CE 5.0)

Send Feedback

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.

typedef struct _DDHAL_LOCKDATA {LPDDRAWI_DIRECTDRAW_GBLlpDD;LPDDRAWI_DDRAWSURFACE_LCLlpDDSurface;DWORDbHasRect;RECTLrArea;LPVOIDlpSurfData;HRESULTddRVal;LPDDHALSURFCB_LOCKLock;DWORDdwFlags;} DDHAL_LOCKDATA;

Members

• lpDD**
  Pointer to the DDRAWI_DIRECTDRAW_GBL structure that represents the DirectDraw object.

• lpDDSurface**
  Pointer to the DDRAWI_DDRAWSURFACE_LCL structure that represents the DirectDrawSurface object.

• 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.

• Lock**
  This member is used by DirectDraw and should not be filled in by the driver.

• dwFlags**
  DDLOCK flags.

  The following table shows the possible flags.

  Flag	Description
  DDLOCK_EVENT	Reserved for future use.
  DDLOCK_READONLY	Specifies the surface being locked will only be read from.
  DDLOCK_SURFACEMEMORYPTR	Indicates that an application's Lock should return a valid memory pointer to the top of the specified rectangle. If no rectangle is specified, a pointer to the top of the surface is returned. This is the default.
  DDLOCK_WAIT	Used by DirectDraw and should not be filled in by the driver.
  DDLOCK_WRITEONLY	Specifies the surface being locked will only be written to.

Requirements

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddrawi.h.

See Also

Lock | DDRAWI_DIRECTDRAW_GBL | DDRAWI_DDRAWSURFACE_LCL | DirectDrawSurface Structures

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.