Share via

SCARD_READER_CAPABILITIES (Windows Embedded CE 6.0)

  • Article

1/6/2010

The SCARD_READER_CAPABILITIES structure holds state information about the reader. It must be completely maintained by the driver.

Syntax

typedef struct _SCARD_READER_CAPABILITIES {
  struct {
    ULONG Async;
    ULONG Sync;
  } SupportedProtocols;
  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 Reserved[25];
} SCARD_READER_CAPABILITIES, *PSCARD_READER_CAPABILITIES;

Members

  • SupportedProtocols
    Mandatory. Must be set to a bit mask that reflects the protocols that this driver or reader supports in hardware and software. Protocol flag definitions are found in winsmcrd.h.

  • ReaderType
    The type of this reader.

    Type Description

    SCARD_READER_TYPE_SERIAL

    Serial reader.

    SCARD_READER_TYPE_PCMCIA

    PCMCIA reader.

    SCARD_READER_TYPE_KEYBOARD

    Keyboard attached reader.

    SCARD_READER_TYPE_USB

    USB reader.

  • MechProperties
    Optional. Contains a mask of reader properties combined with the bitwise OR operator.

    Property Description

    SCARD_READER_SWALLOWS

    Reader is capable of reading cards when they are in position for use.

    SCARD_READER_EJECTS

    Reader is able to eject the card.

    SCARD_READER_CONFISCATES

    Reader is able to capture the card.

  • CurrentState
    Contains the status of the card.

    Status Description

    SCARD_UNKNOWN

    The reader does not know the status.

    SCARD_ABSENT

    No card is currently inserted.

    SCARD_PRESENT

    A card is inserted.

    SCARD_SWALLOWED

    A card is in the reader and is in position for use. The card is not powered.

    SCARD_POWERED

    The card is powered, but the reader does not know its mode.

    SCARD_NEGOTIABLE

    A card is inserted and awaits protocol negotiation.

    SCARD_SPECIFIC

    A card is inserted and a protocol has been selected.
  • Channel
    The port number for serial and parallel port readers, the SCSI identifier number for SCSI readers, 0 for keyboard readers, or the device number for USB readers.
  • ClkFrequency.Default
    Mandatory. This is the standard clock frequency that the reader runs at, in KHz.
  • ClkFrequency.Max
    Mandatory. This is the maximum clock frequency that the reader can run at, in KHz.
  • DataRate.Default
    Mandatory. This is the standard data rate of the reader, in bps.
  • DataRate.Max
    Mandatory. This is the maximum data rate of the reader, in bps.
  • MaxIFSD
    Mandatory. This is the maximum buffer size of the reader. This value is used to inform the smart card at the beginning of a T=1 transmission about the maximum number of bytes that can be received in one packet.
  • PowerMgmtSupport
    The type of power management supported by the smart card. Zero indicates that the card does not support power management.
  • Reserved
    A reserved buffer of 25 ULONG values. Drivers should not use this space.

Requirements

Header smclib.h
Windows Embedded CE Windows CE 3.0 and later

See Also

Reference

Smart Card Driver Structures