SCARD_READER_CAPABILITIES

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

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.

  • 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

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

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.