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

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

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

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

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

リーダーでサポートされているデータレートの一覧 (1 秒あたりのビット数) が含まれます。このメンバーは 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)]

システム用に予約されています。

備考

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

必要条件

要件	価値
ヘッダー	smclib.h (Smclib.h を含む)

次の方法で共有

SCARD_READER_CAPABILITIES構造体 (smclib.h)

構文

メンバーズ

備考

必要条件

フィードバック

その他のリソース