VeriFone MX800 Series - Int Ippread(Char *Buffer, Int Size); Note on the PIN Session Timeout

DEVICE DRIVERS
int ippRead(char *buffer, int size)
M
X
800 SERIES PROGRAMMERS GUIDE 49
int ippRead(char *buffer, int size)
ippRead() transfers data from the IPP FIFO to the application data buffer.
Parameters
Return Values
Note on the PIN session timeout
One of the requirements for application independence in the Payment Card
Industry PED (PIN Entry Device) specification is that there is a default timeout for
PIN entry function calls from the application.
Consequently, the OS implements a PIN session timeout of 5 minutes. This value
is not modifiable. Applications that require a shorter timeout can issue a call to the
following in order to terminate the PIN session earlier:
After expiration of the OS timeout,
buffer Pointer to the data area
size Maximum number of bytes to read
> 0 Number of bytes returned in buffer
0 No data to read
EBADF The task does not own the IPP.
ippTerminatePinEntry() in IPP PIN Entry
iPS_CancelPIN() in VSS PIN Entry
in IPP PIN Entry the IPP sends an <EOT> (0x04) character
in VSS PIN Entry the iStatus value returned by the
iPS_GetPINResponse() function will be set to 0x0C.
Subsequent call to iPS_GetPINResponse() will return
a iStatus value of 0x01 meaning "PINpad idle" (i.e. not
in a PIN session).