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 で使用できます。
ヘッダー	winbio_ioctl.h

関連項目

IOCTL_BIOMETRIC_GET_ATTRIBUTES