Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This method notifies DirectDraw that the direct surface manipulations are complete.
HRESULT Unlock(LPRECT lpRect);
Parameters
- lpRect
Address of the RECT structure that was used to lock the surface in the corresponding call to the IDirectDrawSurface5::Lock method. This parameter can be NULL only if the entire surface was locked by passing NULL in the lpDestRect parameter of the corresponding call to the IDirectDrawSurface5::Lock method.
Return Values
If the method succeeds, the return value is DD_OK.
If the method fails, the return value may be one of the following error values:
| DDERR_GENERIC |
| DDERR_INVALIDOBJECT |
| DDERR_INVALIDPARAMS |
| DDERR_INVALIDRECT |
| DDERR_NOTLOCKED |
| DDERR_SURFACELOST |
Remarks
Because it is possible to call IDirectDrawSurface5::Lock multiple times for the same surface with different destination rectangles, the pointer in lpRect links the calls to the IDirectDrawSurface5::Lock and IDirectDrawSurface5::Unlock methods.
Requirements
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddraw.h.
Link Library: Ddraw.lib.
See Also
Send Feedback on this topic to the authors