PTS_DATA構造体 (smclib.h)

[アーティクル]
02/07/2025

PTS_DATA構造体は、プロトコルの種類の選択 (PTS) に使用されます。

構文

typedef struct _PTS_DATA {
  UCHAR Type;
  UCHAR Fl;
  UCHAR Dl;
  ULONG CLKFrequency;
  ULONG DataRate;
  UCHAR StopBits;
} PTS_DATA, *PPTS_DATA;

メンバーズ

Type

この構造体の残りのメンバーの計算方法を制御します。このメンバーには、次のいずれかの値を指定できます。

PTS_TYPE_DEFAULT

PTS の標準パラメーターを計算します。

PTS_TYPE_OPTIMAL

PTS に最適なパラメーターを計算します。

PTS_TYPE_USER

PTS のユーザー定義パラメーターを計算します。

スマートカードドライバーライブラリは、リーダードライバーがその SmartcardUpdateCardCapabilities (WDM) ルーチンを呼び出すときに、この構造体の残りのメンバーを設定します。ただし、場合によっては、リーダードライバーがこれらのパラメーターを設定する必要があります。たとえば、最適なパラメーターを指定する PTS 要求が失敗した場合、リーダードライバーは、プロトコルを指定するコールバック関数でパラメーターを設定できます。プロトコルを指定するには、コールバック関数で型を PTS_TYPE_DEFAULT に設定し、smartcardUpdateCardCapabilities 再度呼び出 必要があります。

Fl

PTS 要求の PTS1 の一部として使用する Fl 値。

Dl

PTS 要求の PTS1 の一部として使用する Dl 値。

CLKFrequency

クロック周波数を格納します。一部のスマートカードリーダーは、PTS 要求の後に使用する新しいクロック周波数を使用してプログラミングする必要があります。

DataRate

新しいデータレートを格納します。一部のスマートカードリーダー (シリアルリーダーなど) は、PTS 要求後に使用する新しいデータレートに設定する必要があります。

StopBits

挿入されたカードで使用するストップビットの数を格納します。

備考

スマートカードリーダードライバーライブラリは、プロトコルを設定するコールバック関数を呼び出す前に、この構造体のメンバーに値を割り当てます。ドライバーライブラリは、挿入されたスマートカードの特性、サポートされているクロック周波数、および値を割り当てるときにリーダーのサポートされるデータレートを考慮します。

必要条件

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

次の方法で共有