Adds the specified port monitor to the system.
LONG dAddPortMonitor(LPSTR lpMonitorDllName, LPSTR lpMonitorName)
|
Input value: lpMonitorDllName |
The DLL file name. The maximum number of characters is 259. The monitor dll file name cannot contain any of following characters: <>:”/|?* and Black slash \ allowed in full path but not in file name. |
|
Input value: lpMonitorName |
The name of the port monitor. |
|
Return value |
Returns 0 if the port monitor was successfully added, otherwise the function returns the occurred error code by calling the GetLastError() internally. The GetLastError() returns the last error code that has occurred in the system. |
NOTE: This function is outdated, no longer recommended.
Naming convention for Printer Driver files:
|
Printer |
X |
OS |
YY |
|
Color |
C |
Desktop |
NT |
|
ColorPlus |
A |
Server |
TS |
|
EMF |
E |
Evaluation Desktop |
ND |
|
Monochrome |
M |
Evaluation Server |
TD |
|
|
P |
Example:
Driver file name of ColorPlus Desktop:
BuAIniNT.dll
For example: In case of ColorPlus OEM Evaluation: BuAiniND.ini for Desktop, and BuAiniTD.ini for Server. The NT is replaced with ND, and the TS is replaced with TD.
Error code: 5:
The dAddPortMonitor function cannot access the port monitor dll (BuXMonYY.dll) or access the registry (HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print\Monitors\)
Error code: 126:
The port monitor dll (BuXMonYY.dll) is not found in the System32 directory.
Error code: 127:
The port monitor dll (BuXMonYY.dll) version is not correct in the System32 directory or the common dlls where not updated to the latest version.
The list of the Black Ice common dlls are below:
- TIFF32.dll
- JPEG32.dll
- PDF32.dll (Only for ColorPlus and PDF)
- Dib32.dll
- BiPDFInterfaceP.dll (Only in Color, ColorPlus and PDF printer driver)
- BiPDFP.dll (Only in Color, ColorPlus and PDF printer driver)
- BiPDFResources.dll (Only in Color, ColorPlus and PDF printer driver)
- BiImgUser.dll
The common dlls are shared dlls between different Black Ice applications that are using the Black Ice printer drivers.
The printer driver installers need to check the version of the common dlls before copying the dlls into the System32 directory.
If the common dll's version in the System32 directory is older than the new common dll's version, the installer must to overwrite the older dlls.
Error code: 193:
The port monitor dll (BuXMonYY.dll) is not valid for the current platform (32-bit / 64-bit mismatch)
Error code: 1722:
Print Spooler service is not running
Error code: 1805:
The install dll is built for the wrong platform. If you install the printer driver on Windows 32-bit system then use the MyDll_NT.dll (32-bit build version).
If you install the printer driver on Windows 64-bit system using a 32 bit installer then use the MyDll_NT_x64.dll (32-bit build version)
Install the printer driver on Windows 64 bit system and using 64 bit installer use the MyDll_NT.dll (64-bit build version)