Index

C/C++ Functions

pdEngineGetVersion

DT_SLONG pdEngineGetVersion(DT_PDENGINE engine, DT_CHAR* ver_name, DT_CHAR* ver_snum, DT_CHAR* reserved)

Short Description: Get D-Type Power Engine version

This function returns the version of D-Type Engine being utilized.

Parameters

ParameterDescription

engine

Handle of the previously created Power Engine instance.

ver_name

A valid pointer to a buffer supplied by your application that will hold the name of the engine, expressed as a standard ANSI C/C++ string. The size of this buffer must be at least 255 bytes.

However, if you do not wish to receive the value of the above parameter, you may set this pointer to DV_NULL.

ver_snum

A valid pointer to a buffer supplied by your application that will hold the version number of the engine, expressed as a standard ANSI C/C++ string in the following format:

ReleaseNumber.VersionNumber.SubVersionNumber.BuildNr

The size of this buffer must be at least 16 bytes.

However, if you do not wish to receive the value of the above parameter, you may set this pointer to DV_NULL.

reserved

A valid pointer to a buffer reserved for future use. The size of this buffer must be at least 255 bytes. At present, the engine will write an empty string to this buffer.

However, if you do not wish to receive the value of the above parameter, you may set this pointer to DV_NULL.

Return Value

The function returns the version number of D-Type Power Engine being utilized and expressed as an integer. The larger this number is, the more mature the engine is.

Example

DT_CHAR reserved[255];
DT_CHAR ver_name[255];
DT_CHAR ver_snum[16];
DT_SLONG ver_num = pdEngineGetVersion(engine, ver_name, ver_snum, reserved);

printf("%s version %s (%d)\r\n", ver_name, ver_snum, ver_num);

Output:

D-Type Power Engine version 4.0.0.1 (4001)
 

Index