D3DM_LockSurface (Windows Embedded CE 6.0)

1/6/2010

This function is used by the Direct3D Mobile middleware to lock surfaces.

Syntax

typedef DWORD (*D3DM_LOCKSURFACE_PTR)(D3DM_LOCKSURFACE_DATA *);

Parameters

• D3DM_LOCKSURFACE_DATA
  [in, out] A pointer to a D3DM_LOCKSURFACE_DATA structure describing the properties of the lock requested by the middleware.

Return Value

Implement this function so that it returns D3DM_DRIVER_HANDLED when it succeeds and D3DM_DRIVER_NOTHANDLED when it fails.

Remarks

The driver must ensure that a surface's contents remain coherent while a surface is locked. This may require the rendering pipeline to be flushed or stalled if the surface is, for example, a back buffer or depth buffer.

The Direct3D Mobile middleware removes locks on surfaces by calling D3DM_UnlockSurface.

Requirements

See Also

Reference

Direct3D Mobile Driver Functions
D3DM_LOCKSURFACE_DATA
D3DM_UnlockSurface

Concepts

Surface Locks in Direct3D Mobile