View source for DiveDeacquireFrameBuffer

{{DISPLAYTITLE:DiveDeacquireFrameBuffer}}
This function releases exclusive access to the frame buffer.

==Syntax==
 _DiveDeacquireFrameBuffer(hDiveInst)

==Parameters==
;''hDiveInst'' ([[HDIVE]]) - input
:Display engine DIVE instance.

==Returns==
;''rc'' ([[ULONG]]) - returns
:Return codes indicating success or type of failure:
:* '''DIVE_SUCCESS''' If the function succeeds, 0 is returned.
:* '''DIVE_ERR_DEACQUIRE_FAILED''' The deacquire action did not complete successfully.
:* '''DIVE_ERR_INVALID_INSTANCE''' The DIVE instance handle specified in the ''hDiveInst'' parameter is invalid.
:* '''DIVE_ERR_NO_DIRECT_ACCESS''' The display adapter, display driver, or current video mode does not support direct to screen access.

==Remarks==
This function returns an error if the frame buffer is not currently in the acquired state.

==Example Code==
<PRE>
#include <dive.h>

HDIVE hDiveInst;  /* Display engine DIVE instance. */
ULONG rc;         /* Return codes. */

rc = DiveDeacquireFrameBuffer(hDiveInst);
</PRE>

[[Category:Dive]]