Share via


D3DM_LockSurface (Windows CE 5.0)

Send Feedback

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

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 Values

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

OS Versions: Windows CE 5.0
Header: D3dmddk.h.
Link Library: Developer implemented.

See Also

Direct3D Mobile Driver Functions | D3DM_LOCKSURFACE_DATA | D3DM_UnlockSurface | Surface Locks in Direct3D Mobile

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.