Share via

WINBIO_CAPTURE_PARAMETERS 構造体 (winbio_ioctl.h)

  • [アーティクル]

IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL では、WINBIO_CAPTURE_PARAMETERS構造体が入力として使用されます。

構文

typedef struct _WINBIO_CAPTURE_PARAMETERS {
  DWORD                    PayloadSize;
  WINBIO_BIR_PURPOSE       Purpose;
  WINBIO_REGISTERED_FORMAT Format;
  WINBIO_UUID              VendorFormat;
  WINBIO_BIR_DATA_FLAGS    Flags;
} WINBIO_CAPTURE_PARAMETERS, *PWINBIO_CAPTURE_PARAMETERS;

メンバー

PayloadSize

ペイロードの合計サイズ。

Purpose

キャプチャされたデータを使用する方法と、その結果として最適化する方法を指定するWINBIO_BIR_PURPOSEの目的。 一部のセンサーは、データ キャプチャの理由に応じて異なるモードになります。

次のコード例は、WINBIO_BIR_PURPOSEで使用可能なビットマスク値を示しています。

#define WINBIO_NO_PURPOSE_AVAILABLE                     ((WINBIO_BIR_PURPOSE)0x00)
#define WINBIO_PURPOSE_VERIFY                           ((WINBIO_BIR_PURPOSE)0x01)
#define WINBIO_PURPOSE_IDENTIFY                         ((WINBIO_BIR_PURPOSE)0x02)
#define WINBIO_PURPOSE_ENROLL                           ((WINBIO_BIR_PURPOSE)0x04)
#define WINBIO_PURPOSE_ENROLL_FOR_VERIFICATION          ((WINBIO_BIR_PURPOSE)0x08)
#define WINBIO_PURPOSE_ENROLL_FOR_IDENTIFICATION        ((WINBIO_BIR_PURPOSE)0x10)
#define WINBIO_PURPOSE_AUDIT                            ((WINBIO_BIR_PURPOSE)0x80)

Format

返されるデータの WINBIO_REGISTERED_FORMAT 形式を指定します。

VendorFormat

省略可能なWINBIO_UUIDベンダー GUID。 これは、BIR 内のベンダー固有データの優先形式を示します。

Flags

返されるデータのWINBIO_BIR_DATA_FLAGSレベルの処理とその他の属性を指定します。 書式の所有者と種類が Windows 標準の場合は、WINBIO_DATA_FLAG_RAWする必要があります。

次のコード例は、WINBIO_BIR_DATA_FLAGSで使用可能なビットマスク値を示しています。

#define WINBIO_DATA_FLAG_PRIVACY                ((UCHAR)0x02)
#define WINBIO_DATA_FLAG_INTEGRITY              ((UCHAR)0x01)
#define WINBIO_DATA_FLAG_SIGNED                 ((UCHAR)0x04)

#define WINBIO_DATA_FLAG_RAW                    ((UCHAR)0x20)
#define WINBIO_DATA_FLAG_INTERMEDIATE           ((UCHAR)0x40)
#define WINBIO_DATA_FLAG_PROCESSED              ((UCHAR)0x80)

#define WINBIO_DATA_FLAG_OPTION_MASK_PRESENT    ((UCHAR)0x08)   // Always '1'.

要件

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

こちらもご覧ください

IOCTL_BIOMETRIC_CAPTURE_DATA