CreateCAnimDllL()

CAnimDll* CreateCAnimDllL();

Support

Supported from 5.0

Description

Window server defined animation DLL interface.

This function should be the only function exported by the DLL. It is called by the window server, at the request of the animation client, to construct the CAnimDll derived server side DLL class. In other words, an animation DLL is a polymorphic DLL with an interface which is defined by the window server.

For example, for a DLL class DExampleAnimDll the following code must appear in the DLL source file:

// the only exported function in the DLLIMPORT_C CAnimDll* CreateCAnimDllL();

EXPORT_C CAnimDll* CreateCAnimDllL(){return new(ELeave) DExampleAnimDll;}

The use of both IMPORT_C and EXPORT_C statements is required to satisfy different compiler conventions.

Because this interface is defined by the window server, an animation DLL class must be linked against the window server definitions, otherwise linkage will fail. The mechanism is straightforward — include the following in your project mmp file:

For ER5 and before,

TARGETTYPE DLL
deffile WSANIM.DEF
UID 26435858

Post ER5

TARGETTYPE ani
UID 268450594

Notes:

• The change in UID number is because ER5 is a narrow build while post ER5 builds are Unicode.

• The change is the TARGETTYPE is due to new functionality in the tool chain.

Return value

CAnimDll The animation DLL factory.