Drivers/ccid/SCARDCONTOL.txt

List of SCardControl() commands supported by the CCID driver
============================================================

PC/SC provides the SCardControl() function to send commands to the
driver and/or reader. Here is the list of supported commands by the CCID
driver.


PC/SC function prototype
"""""""""""""""""""""""""

LONG SCardControl(
    SCARDHANDLE hCard,
    DWORD       dwControlCode,
    LPCVOID     pbSendBuffer,
    DWORD       cbSendLength,
    LPVOID      pbRecvBuffer,
    DWORD       cbRecvLength,
    LPDWORD     lpBytesReturned     
)

Parameters:

[in]     hCard            Connection made from SCardConnect().
[in]     dwControlCode    Control code for the operation.
[in]     pbSendBuffer     Command to send to the reader.
[in]     cbSendLength     Length of the command.
[out]    pbRecvBuffer     Response from the reader.
[in]     cbRecvLength     Length of the response buffer.
[out]    lpBytesReturned  Length of the response.

If the dwControlCode is not supported the application receives the error
SCARD_E_UNSUPPORTED_FEATURE or SCARD_E_NOT_TRANSACTED as a general error
code.


supported ControlCode
"""""""""""""""""""""

IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE
    defined as SCARD_CTL_CODE(1)

    The pbSendBuffer[] buffer is sent as a PC_to_RDR_Escape CCID command
    For security possible problems this command in possible in the
    following cases only:
    - the reader is a Gemalto (ex Gemplus) reader and the command is:
     . get firmware version
     . switch interface on a ProxDU
    - the ifdDriverOptions (in the Info.plist file) has the bit
      DRIVER_OPTION_CCID_EXCHANGE_AUTHORIZED set

CM_IOCTL_GET_FEATURE_REQUEST
    defined as SCARD_CTL_CODE(3400)

    Implements the PC/SC v2.02.08 Part 10 IOCTL mechanism

IOCTL_FEATURE_VERIFY_PIN_DIRECT
IOCTL_FEATURE_MODIFY_PIN_DIRECT
IOCTL_FEATURE_IFD_PIN_PROPERTIES
IOCTL_FEATURE_MCT_READERDIRECT
IOCTL_FEATURE_GET_TLV_PROPERTIES
    See PC/SC v2.02.08 Part 10

1	List of SCardControl() commands supported by the CCID driver
2	============================================================
3
4	PC/SC provides the SCardControl() function to send commands to the
5	driver and/or reader. Here is the list of supported commands by the CCID
6	driver.
7
8
9	PC/SC function prototype
10	"""""""""""""""""""""""""
11
12	LONG SCardControl(
13	SCARDHANDLE hCard,
14	DWORD dwControlCode,
15	LPCVOID pbSendBuffer,
16	DWORD cbSendLength,
17	LPVOID pbRecvBuffer,
18	DWORD cbRecvLength,
19	LPDWORD lpBytesReturned
20	)
21
22	Parameters:
23
24	[in] hCard Connection made from SCardConnect().
25	[in] dwControlCode Control code for the operation.
26	[in] pbSendBuffer Command to send to the reader.
27	[in] cbSendLength Length of the command.
28	[out] pbRecvBuffer Response from the reader.
29	[in] cbRecvLength Length of the response buffer.
30	[out] lpBytesReturned Length of the response.
31
32	If the dwControlCode is not supported the application receives the error
33	SCARD_E_UNSUPPORTED_FEATURE or SCARD_E_NOT_TRANSACTED as a general error
34	code.
35
36
37	supported ControlCode
38	"""""""""""""""""""""
39
40	IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE
41	defined as SCARD_CTL_CODE(1)
42
43	The pbSendBuffer[] buffer is sent as a PC_to_RDR_Escape CCID command
44	For security possible problems this command in possible in the
45	following cases only:
46	- the reader is a Gemalto (ex Gemplus) reader and the command is:
47	. get firmware version
48	. switch interface on a ProxDU
49	- the ifdDriverOptions (in the Info.plist file) has the bit
50	DRIVER_OPTION_CCID_EXCHANGE_AUTHORIZED set
51
52	CM_IOCTL_GET_FEATURE_REQUEST
53	defined as SCARD_CTL_CODE(3400)
54
55	Implements the PC/SC v2.02.08 Part 10 IOCTL mechanism
56
57	IOCTL_FEATURE_VERIFY_PIN_DIRECT
58	IOCTL_FEATURE_MODIFY_PIN_DIRECT
59	IOCTL_FEATURE_IFD_PIN_PROPERTIES
60	IOCTL_FEATURE_MCT_READERDIRECT
61	IOCTL_FEATURE_GET_TLV_PROPERTIES
62	See PC/SC v2.02.08 Part 10
63