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