dx_GetDllVersion( )

Description | Cautions | Example | Errors | See Also

Name:	dx_GetDllVersion (dwfileverp, dwprodverp)
Inputs:	LPDWORD dwfileverp	Voice DLL Version Number
	LPDWORD dwprodverp	Product version of this release
Returns:	0 if success
	-1 if failure
Includes:	dxxxlib.h
	srllib.h

Description

The dx_GetDllVersion( ) function returns the voice DLL version number for the file and product..

Dialogic DLL Version Number functions return the file version number and product version number. The file version number specifies the version of the DLL. The product version number specifies the version of the software release that includes the DLL. Each function returns both version numbers in hexadecimal format. For example, if the DLL version is 4.13, the function returns it as 0x0004000D. If the product version is 11.3, the function returns it as 0x000bB0003. In each case, the high word represents the major number, and the low word represents the minor number.

This function has the following parameters:

Parameter	Description
dwfileverp	pointer to where to return file version information
dwprodverp	pointer to where to return product version information

Cautions

None.

Example

/*$ dx_GetDllVersion( ) example $*/



#include <windows.h>

#include <srllib.h>

#include <dxxxlib.h>



int InitDevices( )

{

   DWORD dwfilever, dwprodver;



   /************************************************************************

   * Initialize all the DLLs required. This will cause the DLLs to be

   * loaded and entry points to be resolved. Entry points not resolved

   * are set up to point to a default not implemented function in the

   * `C' library. If the DLL is not found all functions are resolved

   * to not implemented.

   ************************************************************************/



   if (sr_libinit(DLGC_MT) == -1) {

      /* Must be already loaded, only reason if sr_libinit( ) was already called */

   }

   /* Call technology specific dx_libinit( ) functions to load Voice DLL */

   if (dx_libinit(DLGC_MT) == -1) {

      /* Must be already loaded, only reason if dx_libinit( ) was already called */

   }

   /*********************************************************************************

   * Voice library initialized so all other Voice functions may be called

   * as normal. Display the version number of the DLL

   **********************************************************************************/

   dx_GetDllVersion(&dwfilever, &dwprodver);

   printf("File Version for Voice DLL is %d.%02d\n",

                               HIWORD(dwfilever), LOWORD(dwfilever));

   printf("Product Version for Voice DLL is %d.%02d\n",

                               HIWORD(dwprodver), LOWORD(dwprodver));



   /* Now open all the Voice devices */



}

Errors

None.

See Also

• fx_GetDllVersion( )
• sr_GetDllVersion( )
• dt_GetDllVersion( )
• vt_GetDllVersion( )

Click here to contact Dialogic Customer Engineering