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.