WINBIO_SENSOR_ATTRIBUTES 構造体 (winbio_ioctl.h)

IOCTL_BIOMETRIC_GET_ATTRIBUTES 構造体は、WINBIO_SENSOR_ATTRIBUTES構造体を出力として返します。

構文

typedef struct _WINBIO_SENSOR_ATTRIBUTES {
  DWORD                           PayloadSize;
  HRESULT                         WinBioHresult;
  WINBIO_VERSION                  WinBioVersion;
  WINBIO_BIOMETRIC_TYPE           SensorType;
  WINBIO_BIOMETRIC_SENSOR_SUBTYPE SensorSubType;
  WINBIO_CAPABILITIES             Capabilities;
  WINBIO_STRING                   ManufacturerName;
  WINBIO_STRING                   ModelName;
  WINBIO_STRING                   SerialNumber;
  WINBIO_VERSION                  FirmwareVersion;
  DWORD                           SupportedFormatEntries;
  WINBIO_REGISTERED_FORMAT        SupportedFormat[1];
} WINBIO_SENSOR_ATTRIBUTES, *PWINBIO_SENSOR_ATTRIBUTES;

メンバー

PayloadSize

固定長構造体と最後の変数データを含む、ペイロードの合計サイズを示す DWORD 値。

WinBioHresult

I/O 操作の状態の詳細を示す HRESULT 値。 次の表に、使用可能な値を示します。

ステータス値	説明
S_OK	操作は正常に完了しました。
HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR)	ドライバーは、デバイスから必要な情報を収集できませんでした。

WinBioVersion

ドライバーでサポートされている WinBio WBDI バージョンを含む型 WINBIO_VERSION の構造体。 WinBio サービスと互換性を持つには、 WinBioVersion には、WinBio サービスの現在のマイナー バージョン以下のマイナー バージョンに加えて、WinBio サービスの現在のメジャー バージョンと同じメジャー バージョンが含まれている必要があります。

SensorType

センサーによって収集される生体認証データを含むWINBIO_BIOMETRIC_TYPE型の DWORD ビットマスク。 Windows 7 では、WINBIO_TYPE_FINGERPRINTのみがサポートされています。

SensorSubType

センサーに関する追加情報を含むWINBIO_BIOMETRIC_SENSOR_SUBTYPEサブタイプ。 たとえば、このメンバーは、センサーにユーザーがセンサーをタッチするか、センサー上で指をスワイプする必要があるかどうかを指定できます。

WINBIO_BIOMETRIC_SENSOR_SUBTYPEには、次の表の値を含めることができます。

生体認証サブタイプの値	説明
WINBIO_FP_SENSOR_SUBTYPE_SWIPE	デバイスでは、ユーザーがセンサーの上に指先をスワイプする必要があります。
WINBIO_FP_SENSOR_SUBTYPE_TOUCH	デバイスでは、ユーザーが指紋全体をセンサー パッドに配置する必要があります。

Capabilities

WINBIO_CAPABILITIES サブタイプ。デバイスでサポートされている機能を示します。

WINBIO_CAPABILITIESには、次の表の値を含めることができます。

生体認証機能の値	説明
WINBIO_CAPABILITY_SENSOR	デバイスは生体認証データを収集できます。
WINBIO_CAPABILITY_MATCHING	デバイスは一致操作を実行できます。
WINBIO_CAPABILITY_STORAGE	デバイスは生体認証テンプレートを格納できます。
WINBIO_CAPABILITY_SECURE_STORAGE	デバイスは、テンプレートに関連付けられているセキュリティで保護されたデータを格納できます。 セキュリティで保護されたデータは、正の一致でのみ解放されます。 デバイスは、システム プールにテンプレートを格納するために使用されるセキュリティで保護されたハッシュ計算のために、少なくとも SHA-1 アルゴリズムをサポートする必要があります。
WINBIO_CAPABILITY_PROCESSING	デバイスはサンプルを処理し、生体認証テンプレートに変換できます。
WINBIO_CAPABILITY_ENCRYPTION	デバイスでは、サンプルとテンプレートの暗号化がサポートされています。
WINBIO_CAPABILITY_SIGNING	デバイスは、キャプチャされたデータに署名できます。
WINBIO_CAPABILITY_NAVIGATION	デバイスはナビゲーション デバイスとして使用できます。 一部のデバイスとドライバーでは、マウスと同様に、ユーザー モード アプリケーションによってナビゲーション イベントに変換できる形式でデータをキャプチャできます。
WINBIO_CAPABILITY_INDICATOR	デバイスには、オンまたはオフにできるインジケーターがあります。
WINBIO_CAPABILITY_VIRTUAL_SENSOR	センサー アダプターは、生体認証ハードウェアへの独自の接続を管理します。 メモ：この定数は、Windows 10 以降にのみ適用されます。
WINBIO_CAPABILITY_SECURE_SENSOR	デバイスは、WinBio エンジン アダプター インターフェイス バージョン 4.0 以降で使用できるセキュリティメソッドをサポートしています。 メモ：この定数は、Windows 10 以降にのみ適用されます。

ManufacturerName

デバイスの製造元の名前を含むWINBIO_STRING型の構造体。

ModelName

デバイス モデルの名前を含むWINBIO_STRING型の構造体。

SerialNumber

デバイスのシリアル番号を含む型WINBIO_STRINGの構造体 (存在する場合)。

FirmwareVersion

デバイス に 読み込まれるファームウェアのバージョンを含む型WINBIO_VERSIONの構造体。

SupportedFormatEntries

ドライバーとデバイスでサポートされている形式の数。 Windows 標準形式の少なくとも 1 つが必要です。

SupportedFormat[1]

ドライバーとデバイスで サポートされている形式 の一覧を含むWINBIO_REGISTERED_FORMAT型の構造体。

要件

要件	値
サポートされている最小のクライアント	Windows 7 以降のバージョンの Windows で使用できます。
Header	winbio_ioctl.h

こちらもご覧ください

IOCTL_BIOMETRIC_GET_ATTRIBUTES