D3DM_UnlockSurface (Windows CE 5.0)

Send Feedback

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

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 Values

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

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

See Also

Direct3D Mobile Driver Functions | D3DM_LockSurface | D3DM_UNLOCKSURFACE_DATA | Surface Locks in Direct3D Mobile

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.