Lock (Windows CE 5.0)
This callback function locks a specified area of surface memory.
DWORD Lock(LPDDHAL_LOCKDATApld);
Parameters
- pld
[in, out] Pointer to a DDHAL_LOCKDATA structure that the driver uses to lock the specified area.
Return Values
Returns one of the following values:
Remarks
An example implementation of this callback function, Lock32, can be found in the IGS sample driver source code.
An emulated blit is a blit performed by the DirectDraw hardware emulation layer (HEL), not the hardware abstraction layer (HAL). During the setup for an emulated blit, the HAL's Lock function is called to obtain a pointer to any display memory surfaces involved in the blit. For such blits, drivers may pass DDLOCK_READONLY or DDLOCK_WRITEONLY to the Lock function. These flags indicate that the host processor only reads from or writes to the surface for the duration of this Lock operation. If neither flag is specified, then the driver should assume that read/write access is required.
Requirements
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddrawi.h.
Link Library: Developer implemented.
See Also
DirectDrawSurface Callback Functions | DDHAL_LOCKDATA | DDHAL_DRIVER_HANDLED | DDHAL_DRIVER_NOTHANDLED
Send Feedback on this topic to the authors