다음을 통해 공유


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 값입니다. 다음 표에는 가능한 값이 포함되어 있습니다.

상태 값 Description
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 다음 표의 값을 포함할 수 있습니다.

생체 인식 하위 형식 값 Description
WINBIO_FP_SENSOR_SUBTYPE_SWIPE 디바이스를 사용하려면 사용자가 센서를 손가락으로 살짝 밀어야 합니다.
WINBIO_FP_SENSOR_SUBTYPE_TOUCH 디바이스를 사용하려면 사용자가 센서 패드에 전체 지문을 배치해야 합니다.

Capabilities

디바이스에서 지원되는 기능을 나타내는 WINBIO_CAPABILITIES 하위 유형입니다.

WINBIO_CAPABILITIES 다음 표의 값을 포함할 수 있습니다.

생체 인식 기능 값 Description
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 표준 형식인 하나 이상이 있어야 합니다.

SupportedFormat[1]

드라이버 및 디바이스에서 지원하는 형식 목록을 포함하는 형식 WINBIO_REGISTERED_FORMAT 구조체입니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다.
머리글 winbio_ioctl.h

추가 정보

IOCTL_BIOMETRIC_GET_ATTRIBUTES