다음을 통해 공유


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에서 사용할 수 있습니다.
헤더 winbio_ioctl.h

참고 항목

IOCTL_BIOMETRIC_CAPTURE_DATA