SCARD_CARD_CAPABILITIES (Windows Embedded CE 6.0)
1/6/2010
The SCARD_CARD_CAPABILITIES structure holds all information about the currently inserted smart card.
Syntax
typedef struct _SCARD_CARD_CAPABILITIES {
BOOLEAN InversConvention;
ULONG etu;
struct {
UCHAR Buffer[64];
UCHAR Length;
} ATR;
struct {
UCHAR Buffer[16];
UCHAR Length;
} HistoricalChars;
PCLOCK_RATE_CONVERSION ClockRateConversion;
PBIT_RATE_ADJUSTMENT BitRateAdjustment;
UCHAR Fl;
UCHAR Dl;
UCHAR II;
UCHAR P;
UCHAR N;
ULONG GT;
struct {
ULONG Supported;
ULONG Selected;
} Protocol;
struct {
UCHAR WI;
ULONG WT;
} T0;
struct {
UCHAR IFSC;
UCHAR CWI;
UCHAR EDC;
ULONG CWT;
ULONG BWT;
ULONG BGT;
} T1;
ULONG Reserved[25];
} SCARD_CARD_CAPABILITIES, *PSCARD_CARD_CAPABILITIES;
Members
- InversConvention
TRUE indicates that the smart card uses the inverse convention.
- etu
The calculated etu value for the smart card.
- ATR.Buffer
The Answer-to-Reset string, after a warm or cold reset.
- ATR.Length
The length of the ATR.
- HistoricalChars.Buffer
A 16 byte buffer of historical data.
- HistoricalChars.Length
The actual number of bytes used in HistoricalChars.Buffer.
- PCLOCK_RATE_CONVERSION
A pointer to a clock rate conversion table.
- PBIT_RATE_ADJUSTMENT
A pointer to a bit rate adjustment table.
- Fl
The clock rate conversion.
- Dl
The bit rate adjustment.
- II
The smart card's maximum programming current.
- P
The programming voltage, in units of 0.1 volts.
- N
The amount of extra guard time in etu.
- GT
The guard time in microseconds, including any extra guard time, for the minimum delay between two consecutive characters.
- Protocol.Supported
A bit mask of the supported protocols.
- Protocol.Selected
The currently selected protocol.
- T0.WI
The T=0 waiting integer.
- T0.WT
The T=0 work waiting time, in microseconds. This is the maximum delay between two consecutive characters.
- T1.IFSC
The information field size of the smart card.
- T1.CWI
The T=1 character waiting integer.
- T1.BWI
The T=1 block waiting integer.
- T1.EDC
The T=1 error detection code.
- T1.CWT
The T=1 character waiting time, in microseconds. This is the maximum delay between two consecutive characters.
- T1.BWT
The T=1 block waiting time, in microseconds. This is the maximum delay between the end of a block and the start of the next block sent in the opposite direction.
- T1.BGT
The T=1 block guarding time, in microseconds. This is the minimum delay between the end of a block and the start of the next block sent in the opposite direction.
- Reserved
An array of 25 ULONG values, reserved for future use. Smart card drivers should not use this space.
Remarks
SCARD_CARD_CAPABILITIES holds information about the currently inserted smart card. If the driver uses the Smart Card Driver Library, then ATR is the only member that the driver must fill in. Fill ATR.Buffer with the ATR characters and ATR.Length with the number of ATR bytes returned by the card. The Smart Card Driver Library will automatically update all other fields when a call is made to IOCTL_SMARTCARD_SET_PROTOCOL.
Requirements
| Header | smclib.h |
| Windows Embedded CE | Windows CE 3.0 and later |