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 |