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

#include <dive.h>

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

rc = DiveDeacquireFrameBuffer(hDiveInst);