SmartcardUpdateCardCapabilities (WDM) routine

The SmartcardUpdateCardCapabilities routine translates an answer-to-reset (ATR) string into the SCARD_CARD_CAPABILITIES structure that the driver can use.

Syntax

NTSTATUS SmartcardUpdateCardCapabilities(
   PSMARTCARD_EXTENSION SmartcardExtension
);

Parameters

  • SmartcardExtension
    A pointer to a SMARTCARD_EXTENSION structure that contains the device extension of the smart card device.

Return value

SmartcardUpdateCardCapabilities returns one of the following NTSTATUS values:

Return code Description
STATUS_SUCCESS

The ATR string was translated successfully.

STATUS_UNRECOGNIZED_MEDIA

One of three conditions is true: the ATR string does not start with 0x3B or 0x3F, the ATR string contains a value for Fl or Dl that does not conform with the ISO standard, or the ATR checksum for T=1 is wrong.

 

Remarks

The driver should call this routine only after it has read the ATR string into the ATR member of the SCARD_CARD_CAPABILITIES structure. The driver must store the ATR bytes in the Buffer member, and it must adjust the Length member to the actual length of the ATR string.

This routine can handle only T=0 and T=1 smart cards.

This routine converts the ATR string into the values that are defined by the ISO 7816-3 standard. All these values are stored in the SCARD_CARD_CAPABILITIES structure. All of the time values in the structure are in microseconds.

Requirements

Target platform

Desktop

Version

Available in Windows XP and later versions of Windows.

Header

Smclib.h (include Smclib.h)

Library

Smclib.lib

IRQL

<= DISPATCH_LEVEL

See also

SCARD_CARD_CAPABILITIES

SMARTCARD_EXTENSION

 

 

Send comments about this topic to Microsoft