SCARD_READER_CAPABILITIES structure (smclib.h)

The SCARD_READER_CAPABILITIES structure holds state information about the smart card reader.

Syntax

typedef struct _SCARD_READER_CAPABILITIES {
  ULONG                    SupportedProtocols;
  ULONG                    Reserved;
  ULONG                    ReaderType;
  ULONG                    MechProperties;
  ULONG                    CurrentState;
  ULONG                    Channel;
  struct {
    ULONG Default;
    ULONG Max;
  } CLKFrequency;
  struct {
    ULONG Default;
    ULONG Max;
  } DataRate;
  ULONG                    MaxIFSD;
  ULONG                    PowerMgmtSupport;
  ULONG                    CardConfiscated;
  struct {
    PULONG List;
    UCHAR  Entries;
  } DataRatesSupported;
  _DataRatesSupported      _DataRatesSupported;
  struct {
    PULONG List;
    UCHAR  Entries;
  } CLKFrequenciesSupported;
  _CLKFrequenciesSupported _CLKFrequenciesSupported;
  UCHAR                    Reserved1[100 - sizeof(ULONG)- sizeof(struct _DataRatesSupported)- sizeof(struct _CLKFrequenciesSupported)];
} SCARD_READER_CAPABILITIES, *PSCARD_READER_CAPABILITIES;

Members

SupportedProtocols

Must be set to a bitmask that reflects the asynchronous or synchronous protocols that the card reader and card reader driver support. This member is required.

Reserved

Reserved for system use.

ReaderType

This member contains the reader type and is required. This member can have one of the values in the following table.

MechProperties

Contains a value that is formed by taking a bitwise OR of all applicable reader properties shown in the following table. This member is optional.

CurrentState

This member contains the status of the card and is required. This member can have one of the values listed in the following table.

Access to this field must be sequentialized by using the spin lock pointed to by the OsData->SpinLock member of SMARTCARD_EXTENSION.

Channel

Contains the logical channel number. This member is optional. The exact meaning of this member depends on the type of smart card, as shown in the following table.

For more information, see Part 3 of the Interoperability Specification for ICCs and Personal Computer Systems.

CLKFrequency

A structure with the following members:

CLKFrequency.Default

Contains the standard clock frequency at which the reader runs, in kilohertz, and encoded in little-endian format. For example, 3.58 MHz is encoded as 3580. This member is required.

CLKFrequency.Max

Contains the maximum clock frequency at which the reader can run, in kilohertz, and encoded in little-endian format. This member is required.

DataRate

A structure with the following members:

DataRate.Default

Contains the standard data rate of the reader, in units of bits per second, and encoded in little-endian format. This member is required.

DataRate.Max

Contains the maximum data rate of the reader, in units of bits per second, and encoded in little-endian format. This member is required.

MaxIFSD

Contains the maximum buffer size of the reader. This value informs the smart card at the beginning of a T=1 transmission of the maximum number of bytes that can be received in one packet. This member is required.

PowerMgmtSupport

Indicates the type of power management that the card supports. A value of zero indicates that the smart card does not support power management.

CardConfiscated

If TRUE, indicates that the smart card was confiscated.

DataRatesSupported

A structure with the following members:

DataRatesSupported.List

Contains a list of data rates, in bits per second, that are supported by the reader. This member is used with the PTS request. The reader driver usually sets this member to a pointer to a static array of unsigned long values that contain the supported data rates. If the reader does not support different data rates, leave this member empty. This member is optional.

DataRatesSupported.Entries

Contains the number of linked list entries in DataRatesSupported.List. This member is optional.

_DataRatesSupported

A structure with the following members:

CLKFrequenciesSupported

A structure with the following members:

CLKFrequenciesSupported.List

Contains a list of clock frequencies, in kilohertz, that are supported by the reader. This member is used with the PTS request. The driver usually sets this member to a pointer to a static array of unsigned long values that contain the supported clock frequencies. If the reader does not support different clock frequencies, leave this member empty. This member is optional.

CLKFrequenciesSupported.Entries

Contains the number of linked list entries of CLKFrquenciesSupported.List. This member is optional.

_CLKFrequenciesSupported

A structure with the following members:

Reserved1[100 - sizeof(ULONG)- sizeof(struct _DataRatesSupported)- sizeof(struct _CLKFrequenciesSupported)]

Reserved for system use.

Remarks

This structure must be maintained by the smart card reader driver.

Requirements