LPDDHALSURFCB_LOCK (Windows Embedded CE 6.0)

1/6/2010

This callback function locks a specified area of surface memory.

Syntax

DWORD (* LPDDHALSURFCB_LOCK)(
  LPDDHAL_LOCKDATA lpld
);

Parameters

• lpld
  [in, out] Pointer to a DDHAL_LOCKDATA structure that the driver uses to lock the specified area.

Return Value

Returns one of the following values:

• DDHAL Callback Return Values
• DDHAL Callback Return Values

Remarks

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

Header	ddrawi.h
Library	Developer Implemented
Windows Embedded CE	Windows Embedded CE 6.0 and later

See Also

Reference

DDHAL_LOCKDATA

Concepts

DirectDrawSurface Callback Functions
DDHAL Callback Return Values
DDHAL Callback Return Values