 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The DDHAL_LOCKDATAstructure contains information necessary to do a Lock as defined by DirectDraw's parameter structures. This structure passes the information to the DirectDraw HAL Lockcallback function.
typedef struct _DDHAL_LOCKDATA { LPDDRAWI_DIRECTDRAW_GBL
lpDD
;
LPDDRAWI_DDRAWSURFACE_LCL
lpDDSurface
;
DWORD
bHasRect
;
RECTL
rArea
;
LPVOID
lpSurfData
;
HRESULT
ddRVal
;
LPDDHALSURFCB_LOCK
Lock
;
DWORD
dwFlags
;
} DDHAL_LOCKDATA;
Members
- lpDD
- Pointer to the DDRAWI_DIRECTDRAW_GBLstructure that represents the DirectDraw object.
- lpDDSurface
- Pointer to the DDRAWI_DDRAWSURFACE_LCLstructure 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.
Flag Usage DDLOCK_EVENT This flag is not currently used, and is reserved for future use. DDLOCK_READONLY Specifies the surface being locked will only be read from. DDLOCK_SURFACEMEMORYPTR Set to indicate that an application's Lockshould 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 This flag is used by DirectDraw and should not be filled in by the driver. DDLOCK_WRITEONLY Specifies the surface being locked will only be written to.
Last updated on Tuesday, July 13, 2004