Share via


D3DM_UnlockSurface (Windows Embedded CE 6.0)

1/6/2010

This function is called by the Direct3D Mobile middleware to remove the locks on surfaces previously locked by calls to D3DM_LockSurface.

Syntax

typedef DWORD (*D3DM_UNLOCKSURFACE_PTR)(D3DM_UNLOCKSURFACE_DATA *);

Parameters

  • D3DM_UNLOCKSURFACE_DATA
    [in, out] A pointer to a D3DM_UNLOCKSURFACE_DATA structure describing the surface to unlock.

Return Value

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

Remarks

The retail Direct3D Mobile middleware allows unlocking calls from the application to pass through to D3DM_UnlockSurface even if the surface was not previously locked. It is a good practice to detect this case in your driver and return an error value in D3DM_UNLOCKSURFACE_DATA.rval so that value can be passed on to the application.

Requirements

Header d3dmddk.h
Library Developer Implemented
Windows Embedded CE Windows CE 5.0

See Also

Reference

Direct3D Mobile Driver Functions
D3DM_LockSurface
D3DM_UNLOCKSURFACE_DATA

Concepts

Surface Locks in Direct3D Mobile