DiveClose

This function closes a display engine instance.

Syntax

_DiveClose(hDiveInst)

Parameters

hDiveInst (HDIVE) - input

Instance identifier. All data associated with this instance is freed.

Returns

rc (ULONG) - returns

Return codes indicating success or type of failure:

• DIVE_SUCCESS If the function succeeds, 0 is returned.
• DIVE_ERR_INVALID_INSTANCE The DIVE instance handle specified in the hDiveInst parameter is invalid.

Remarks

This section has no remarks.

Example Code

#include <dive.h>

HDIVE hDiveInst;  /* Instance identifier. */
ULONG rc;         /* Return codes. */

rc = DiveClose(hDiveInst);