FaxMan Jr
Installing the FaxMan NT4/Win2k/XP Printer Driver

Installing the FaxMan NT 4.0/Windows 2000/XP Printer Driver

 

The printer driver may only be installed in one way:

 

 

You may use any method although the easiest method is to use the FaxInstall utility. It’s a console application that can be run from the commandline and can be run from an install program. In fact the FaxMan installation uses FaxInstall to install the NT/Win2K/XP drivers when you run it under Windows NT/Win2K/XP. We also include the source code for the FaxInstall utility so you can customize it if you wish.

 

Important

When installing the FaxMan printer driver it must be installed so that it uses a Port controlled by the FaxMan Port Monitor. If the Driver is assigned to a local port or a port controlled by another port monitor then the driver will not be able to produce fax files. To confirm the port type, select the Ports tab in the printer properties dialog and verify that the type of Port is DataTech Fax Port.

 

1. Using the FaxInstall Utility

 

Because of the different methods and files required when installing the FaxMan printers drivers on different operating systems, we’ve included a printer driver installation utility called faxinstall.exe. It’s a Win32 console app that can be called from an installer or a batch file and will automatically copy the proper files and invoke the proper API functions when installing drivers on Windows 95, Windows 98, Windows NT, and Windows 2000/XP systems.

 

We recommend that you use the Faxinstall utility in your own application’s install, thus eliminating the hassle of calling different APIs on each OS. To use it you need to copy all the files in the Printers directory into a directory in your installation. This printers directory includes install files for Windows 95, Windows 98, Windows NT 4, and Windows 2000/XP. In your install you can then call FaxInstall as documented below and it will install the appropriate driver based on the OS it’s running on.

 

We’ve even included the C source code and Visual C++ 5.0 project in a zip file called printsrc.zip to allow you to modify the utility if you wish.

 

The syntax is:

 

faxinstall <PortName> <ApplicationPath> <PrinterDriverName> <PrinterFiles Path>

 

example:

c:\tempdrv> faxinstall FaxDrv C:\progra~1\Myprogram\myprogram.exe "Fax Driver for MyProgram" c:\tempdrv >c:\tempdrv\result.txt 

 

The fourth parameter of .\. assumes that you have all the files from the FaxmanJr\printers folder located in c:\tempdrv.

 

The > on the end will dump out the results to a text file. This could then be sent to you and forwarded on to support for problem solving if there were problems during the installation. Starting with version 1.51 this is not necessary, as the information is automatically dumped to the xinstall.log, which will be found in the same dir as Faxinstall.exe

  

<PortName>ESSENTIAL! This is identical to the AppID for the FaxMan control in your project. Also check that the FaxMan control's visible property is set to TRUE. And check that a file name is supplied in the PrintStart event for the FaxMan control.

 

<ApplicationPath> is the path and name of the exe of your application that has FaxManJr in it. This is not necessarily the name of the application that will be printing.

 

<PrinterDriverName> is the name you wish to call the Driver, i.e. "Bobs Fax Driver" or whatever you want. Be sure to enclose the string in quotation marks if it has spaces. Note: Faxinstall’s programs parameters are space delimited.

 

<PrinterFilesPath> specifies the path of the printer driver files to be copied from (example c:\printers).Note: a trailing \ (c:\printers\) will cause a failure. 

 

 

2. FaxInstall’s Alternate Usage

 

FaxInstall accepts the fullpath filename of a configuration file as the only parameter. The file is in an "ini" format.

 

c:\tempdrv> faxinstall c:\tempdrv\my.ini

 

Here is an example configuration file:

 

 

[FaxInstall]

PortName=VBFaxJr

PrinterName=FaxManJr VB6app

AppPath=C:\Program Files\FaxManJr\VBfmjr\VB6FaxJr.exe

HookDLL=

PrinterFiles= C:\Program Files\FaxManJr \printers

Resolution=2

PageSize=2

PageOrientation=1

 

This file will install a printer driver for use without a hook dll. The default

resolution for this printer driver will be high, and the default paper size

will be Letter.

 

Here are the possible parameters.

PortName:

 limit 20 characters

 Must match AppId in application

 Default = "FaxDrv"

PrinterName:

 limit 40 characters

 User friendly printer driver name

 Default = "Fax Driver"

AppPath:

 limit 255 characters

 full path name to application associated with driver

 No Default

HookDLL:

 limit 50 characters

 Specify DLL name only and place DLL in path

 No Default

PrinterFiles:

 limit 255 characters

 Path to the necessary printer files.

 Default = Directory Faxinstall.exe is run from.

Resolution:

 1 = Low

 2 = High, default

PageSize:

 1 = Letter, default

 2 = A4

 3 = Legal

PageOrientation:

 1 = Portrait, default

 2 = Landscape

ReplaceFiles

 0 = Replace All files

 1 = Replace non-system files only, default

 2 = Replace no files only copy if files not present

 3 = Do not copy any files

 

 

 

 


© 2014 Data Techniques, Inc. All Rights Reserved.

Send comments on this topic.