SplPdInitPort

SplPdInitPort initializes a port on behalf of the spooler.

Syntax
SplPdInitPort(hfile, pszPortName);

Parameters

 * hfile (HFILE) - input : The handle to an open file.


 * pszPortName (PSZ) - input : The name of the port to be initialized.

Returns

 * rc (APIERR) - returns : Return codes.

This handling routine returns the following errors:
 * ERROR_INVALID_PARAMETER
 * NO_ERROR

Sample

 * 1) include 

HFILE    hfile;        /*  The handle to an open file. */ PSZ      pszPortName;  /*  The name of the port to be initialized. */ APIERR   rc;           /*  Return codes. */

rc = SplPdInitPort(hfile, pszPortName);

Remarks
The port driver reads the initialization data from the INI file, interprets the data, and issues the appropriate DosDevIOCtl calls to the open port given by the file handle.

This function is called from the spooler function, PrtOpen, to complete port opening. Note that PrtOpen issues the actual DosOpen first. PrtOpen holds a semaphore for each port in use, and a linked list of threads waiting on the semaphore because, although the spooler serializes output, it is still possible for applications to write directly to the port by using DevOpenDC (OD_DIRECT).