 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The SCARD_CARD_CAPABILITIESstructure holds all information about the currently inserted smart card.
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;
UCHARCWI;
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 guart time.
- 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.
Comments
SCARD_CARD_CAPABILITIESholds information about the currently inserted smart card. If the driver uses the Smart Card Driver Library, then ATRis the only member that the driver must fill in. Fill ATR.Buffer with the ATR characters and ATR.Lengthwith 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.
Last updated on Tuesday, July 13, 2004