PathEngine home previous: PathEngine_SetDefaultAllocatornext: PathEngine_ShutDownCP3D
Contents, API Reference, Functions, PathEngine_ShutDown

PathEngine_ShutDown

Description

Shuts down PathEngine explicitly (static and Linux .so linkage).

Syntax

This function is defined in 'SDKRoot/interface/PathEngine_DirectLinkage.h', (included in the source code archives), as follows:
extern "C"
{
	void PathEngine_ShutDown();
}

Remarks

This function is provided to enable explicit SDK shutdown to be requested, in the case of either direct linkage to PathEngine as a set of static libraries, or Linux shared object linkage.
In the case of DLL linkage this method is not available, and the SDK can instead be shutdown when desired by unloading the PathEngine dll.

The host OS will generally take care of cleaning up all allocated resources on process completion, but this method may be called to shutdown PathEngine and release any resources allocated explicitly by PathEngine, before process completion, if this is required.

Note that in certain cases it is possible for memory to be allocated by third party code (such as a compiler supplied standard C library) for things like internal pooling or caching, so in these cases it is possible for some memory to remain allocated after shutdown.

This function should only be called when the SDK has been initialised (with PathEngine_InitialiseAndObtainRootInterface) and not already shut down.

This function must be called from the main thread.


Documentation for PathEngine release 6.00 - Copyright © 2002-2016 PathEnginenext: PathEngine_ShutDownCP3D