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

See Also

Reference

Smart Card Driver Structures
IOCTL_SMARTCARD_SET_PROTOCOL