Jump to content

SplPdResetAbort: Difference between revisions

From EDM2
Created page with "SplPdResetAbort is an API exported by port drivers. It is called by PrtResetAbort to reset an aborted device handle to again allow writes. After the reset is successful, the p..."
 
No edit summary
 
Line 8: Line 8:


== Parameters ==
== Parameters ==
; hDevice ([[HFILE]]) - input : Handle from SplPdOpen.  
; ''hDevice'' ([[HFILE]]) - input : Handle from SplPdOpen.  


== Returns ==
== Returns ==
; rc ([[ULONG]]) - returns : Return codes.  
; ''rc'' ([[ULONG]]) - returns : Return codes.  
* 0 Success  
* 0 Success  
* 6(ERROR_INVALID_HANDLE)  
* 6(ERROR_INVALID_HANDLE)  
: Invalid handle given.  
: Invalid handle given.  


== Remarks ==
SplPdClose must still be issued to close the device connection.


== Sample ==
== Sample ==
Line 30: Line 32:
</pre>
</pre>


== Remarks ==
SplPdClose must still be issued to close the device connection.


[[Category:Spl]]
[[Category:Spl]]

Latest revision as of 04:28, 3 September 2025

SplPdResetAbort is an API exported by port drivers. It is called by PrtResetAbort to reset an aborted device handle to again allow writes. After the reset is successful, the printer driver is allowed to call PrtWrite for the device handle to send the reset sequence to the printer.

Note
Resetting an aborted device handle does not initiate a new printer job. It only allows writes to be sent to the printer.

SplPdResetAbort is an optional API; it does not have to be exported by the port driver.

Syntax

SplPdResetAbort(hDevice);

Parameters

hDevice (HFILE) - input
Handle from SplPdOpen.

Returns

rc (ULONG) - returns
Return codes.
  • 0 Success
  • 6(ERROR_INVALID_HANDLE)
Invalid handle given.

Remarks

SplPdClose must still be issued to close the device connection.

Sample

#define INCL_SPL
#define INCL_SPLBIDI
#include <os2.h>

HFILE    hDevice;  /*  Handle from SplPdOpen. */
ULONG    rc;       /*  Return codes. */

rc = SplPdResetAbort(hDevice);