 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The IDirectDrawSurface5::Unlockmethod notifies DirectDraw that the direct surface manipulations are complete.
HRESULT Unlock( LPRECT lpRect );
Parameters
- lpRect
- Address of the
RECTstructure that was used to lock the surface in the
corresponding call to the
IDirectDrawSurface5::Lockmethod. This parameter can be NULL
only if the entire surface was locked by passing NULL in the
lpDestRectparameter of the corresponding call to the
IDirectDrawSurface5::Lockmethod.
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::Lockmultiple times for the same surface with different destination rectangles, the pointer in lpRectlinks the calls to the IDirectDrawSurface5::Lockand IDirectDrawSurface5::Unlockmethods.
Requirements
Runs on Versions Declared in Link to Windows CE OS 2.12 or later. Version 2.12 requires DXPAK 1.0 or later. ddraw.h ddraw.lib See Also