SCARD_READER_CAPABILITIES 構造体 (smclib.h)

[アーティクル]
08/07/2023

SCARD_READER_CAPABILITIES構造体は、スマートカードリーダーに関する状態情報を保持します。

構文

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;

メンバー

SupportedProtocols

カードリーダーとカードリーダードライバーでサポートされる非同期または同期プロトコルを反映するビットマスクに設定する必要があります。このメンバーは必須です。

Reserved

システムで使用するために予約されています。

ReaderType

このメンバーにはリーダーの種類が含まれており、必須です。このメンバーは、次の表のいずれかの値を持つことができます。

値	意味
SCARD_READER_TYPE_SERIAL	シリアルリーダー
SCARD_READER_TYPE_PCMCIA	PCMCIA リーダー
SCARD_READER_TYPE_KEYBOARD	キーボード接続リーダー
SCARD_READER_TYPE_USB	USB リーダー
SCARD_READER_TYPE_PARALELL	並列リーダー
SCARD_READER_TYPE_SCSI	SCSI リーダー
SCARD_READER_TYPE_IDE	IDE リーダー
SCARD_READER_TYPE_TPM	キーマテリアルストレージと暗号化操作に TPM チップを使用するリーダー
SCARD_READER_TYPE_VENDOR	独自のベンダーバスを使用するリーダー

MechProperties

次の表に示す該当するすべてのリーダープロパティのビットごとの OR を使用して形成される値を格納します。このメンバーは省略可能です。

値	意味
SCARD_READER_SWALLOWS	リーダーには、飲み込みメカニズムがあります。
SCARD_READER_EJECTS	リーダーはスマートカードを取り出すことができます。
SCARD_READER_CONFISCATES	リーダーはスマートカードを飲み込むことができます。

CurrentState

このメンバーには、カードの状態が含まれており、必須です。このメンバーには、次の表に示す値のいずれかを指定できます。

Status	意味
SCARD_UNKNOWN	リーダーには、状態に関する情報がありません。
SCARD_ABSENT	スマートカードは挿入されません。
SCARD_PRESENT	スマートカードが挿入されます。
SCARD_SWALLOWED	スマートカードが挿入され、リーダーがそれを飲み込んだ。
SCARD_POWERED	スマートカードはオンになっていますが、リーダーはそのモードを認識しません。
SCARD_NEGOTIABLE	スマートカードが挿入され、プロトコルネゴシエーションが待機されます。
SCARD_SPECIFIC	スマートカードが挿入され、プロトコルが選択されています。

このフィールドへのアクセスは、SMARTCARD_EXTENSION の OsData-SpinLock> メンバーが指すスピンロックを使用して順次化する必要があります。

Channel

論理チャネル番号を格納します。このメンバーは省略可能です。このメンバーの正確な意味は、次の表に示すように、スマートカードの種類によって異なります。

スマートカードの種類	チャネルフィールドの値の意味
シリアルリーダー	ポート番号
並列リーダー	ポート番号
SCSI リーダー	SCSI ID
キーボードリーダー	0
USB リーダー	デバイス番号

詳細については、「 ICC とパーソナルコンピューターシステムの相互運用性の仕様」のパート 3 を参照してください。

CLKFrequency

次のメンバーを持つ構造体。

CLKFrequency.Default

リーダーが実行され、キロヘルツ単位で、リトルエンディアン形式でエンコードされる標準クロック周波数が含まれます。たとえば、3.58 MHz は 3580 としてエンコードされます。このメンバーは必須です。

CLKFrequency.Max

リーダーが実行できる最大クロック周波数をキロヘルツ単位で格納し、リトルエンディアン形式でエンコードします。このメンバーは必須です。

DataRate

次のメンバーを持つ構造体。

DataRate.Default

リーダーの標準データレートを 1 秒あたりのビット単位で格納し、リトルエンディアン形式でエンコードします。このメンバーは必須です。

DataRate.Max

リーダーの最大データレートを 1 秒あたりのビット単位で格納し、リトルエンディアン形式でエンコードします。このメンバーは必須です。

MaxIFSD

リーダーの最大バッファーサイズを格納します。この値は、T=1 送信の先頭にあるスマートカードに、1 つのパケットで受信できる最大バイト数を通知します。このメンバーは必須です。

PowerMgmtSupport

カードがサポートする電源管理の種類を示します。 0 の値は、スマートカードが電源管理をサポートしていないことを示します。

CardConfiscated

TRUE の場合は、スマートカードが没収されたことを示します。

DataRatesSupported

次のメンバーを持つ構造体。

DataRatesSupported.List

リーダーでサポートされているデータレートの一覧 (ビット/秒) が含まれます。このメンバーは PTS 要求と共に使用されます。リーダードライバーは通常、サポートされているデータレートを含む符号なし long 値の静的配列へのポインターにこのメンバーを設定します。リーダーが異なるデータレートをサポートしていない場合は、このメンバーを空のままにします。このメンバーは省略可能です。

DataRatesSupported.Entries

DataRatesSupported.List のリンクリストエントリの数を格納します。このメンバーは省略可能です。

_DataRatesSupported

次のメンバーを持つ構造体。

CLKFrequenciesSupported

次のメンバーを持つ構造体。

CLKFrequenciesSupported.List

リーダーでサポートされているクロック周波数の一覧 (キロヘルツ単位) が含まれています。このメンバーは PTS 要求と共に使用されます。ドライバーは通常、サポートされているクロック周波数を含む符号なし長い値の静的配列へのポインターにこのメンバーを設定します。リーダーが異なるクロック周波数をサポートしていない場合は、このメンバーを空のままにします。このメンバーは省略可能です。

CLKFrequenciesSupported.Entries

CLKFrquenciesSupported.List のリンクリストエントリの数を格納します。このメンバーは省略可能です。

_CLKFrequenciesSupported

次のメンバーを持つ構造体。

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

システムで使用するために予約されています。

注釈

この構造は、スマートカードリーダードライバーによって維持される必要があります。

要件

要件	値
Header	smclib.h (Smclib.h を含む)

次の方法で共有

SCARD_READER_CAPABILITIES 構造体 (smclib.h)

構文

メンバー

注釈

要件

フィードバック

その他のリソース