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 |