DD_LOCKDATA

typedef struct _DD_LOCKDATA{
    PDD_DIRECTDRAW_GLOBAL        lpDD;
    PDD_SURFACE_LOCAL            lpDDSurface;
    DWORD                        bHasRect;
    RECTL                        rArea;
    LPVOID                       lpSurfData;
    HRESULT                      ddRVal;
    VOID *                       Lock;
    DWORD                        dwFlags;
} DD_LOCKDATA;

The DD_LOCKDATA structure is passed to the DirectDraw hardware interface’s Lock surface object callback.

Members

lpDD

Pointer to the DD_DIRECTDRAW_GLOBAL structure that describes the driver.

lpDDSurface

Pointer to the DD_SURFACE_LOCAL structure that describes the surface associated with the memory region to be locked.

bHasRect

BOOLEAN that specifies whether rArea is valid.

rArea

RECTL that specifies the area on the surface to be locked down.

lpSurfData

Location in which the driver returns a pointer to the memory region that it locked down.

ddRVal

Location in which the driver returns a DirectDraw status return code. The status codes are defined in ddraw.h.

Lock

Unused by Windows NT.

dwFlags

Bitfield that tells the driver how to perform the memory lockdown. The DDLOCK_Xxx bit fields are enumerated in ddraw.h.