Share via

SCARD_CARD_CAPABILITIES (Windows CE 5.0)

  • Article

Send Feedback

The SCARD_CARD_CAPABILITIES structure 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;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 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.

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

OS Versions: Windows CE 3.0 and later.
Header: Smclib.h.

See Also

IOCTL_SMARTCARD_SET_PROTOCOL

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.