ACS APG8201-B2, Reference Manual

Page: 41 / 48

APG8201-B2
– Reference Manual
info@acs.com.hk
Version 1.00
www.acs.com.hk
Page 41 of 48
www.acs.com
.hk
9.3.7. IOCTL_SMARTCARD_READ_KEY
The IOCTL_SMARTCARD_READ_KEY enables Read Key command.
Input:
hCard Reference value returned from SCardConnect
dwControlCode IOCTL_SMARTCARD_READ_KEY
lpInBuffer Set value for Display LCD message option
nInBufferSize sizeof (ULONG) of lpInBuffer
Output:
lpOutBuffer Output value of command
nOutBufferSize sizeof (ULONG) of lpOutBuffer
lpBytesReturned Pointer to a DWORD that receives the size, in bytes, of the data stored into
the buffer pointed to by lpOutBuffer .
Offset Field Size Value Description
0 abStatus 2
0000h
0001h
SUCCESS
BAD_PARAMETER
2
bKeyReturnCondition
1
31h
32h
33h
34h
Maximum size reached
Key [E] pressed
Timeout occurred
Key [C] pressed
3 abNumericInputKeys 0-32 - -
Offset Field Size Value Description
0 bTimeOut 1 -
Number of seconds. If value is
equal to 00h, then the default
value is used.
1
wPINMaxExtraDigit
2 XXYYh
XXh: Maximum PIN size in digit
YYh: Minimum PIN size in digit
3
bKeyReturnCondition
1 -
The value is a bit wise OR
operation.
01h: Maximum size reached
02h: Key [E] pressed
04h: Timeout occurred
08h: Key [C] pressed
4 bEchoLCDStartPosition 1 - Starting position (0
– 31)
5 bEchoLCDMode 1 -
00h: Echo key press data
ASCII representation to LCD
01h: Display all key presses as
asterisks “*” on LCD