IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL(winbio_ioctl.h)
IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL은 드라이버에게 생체 인식 데이터의 다음 검사를 검색하도록 지시합니다. 이 호출은 디바이스를 캡처 모드로 전환해야 합니다. 공급업체에서 제공하는 WBDI 드라이버는 IOCTL_BIOMETRIC_CAPTURE_DATA 지원해야 합니다.
주 코드
입력 버퍼
입력 버퍼 길이
WINBIO_CAPTURE_PARAMETERS 구조체의 길이입니다.
출력 버퍼
AssociatedIrp.SystemBuffer 멤버는 WINBIO_CAPTURE_DATA 구조체가 포함된 버퍼를 가리킵니다.
WINBIO_BIR 구조의 공급업체별 데이터는 공급업체가 드라이버에서 수집하려는 형식일 수 있습니다. 공급업체는 WBDI 드라이버 또는 엔진 어댑터에서 데이터를 처리하도록 선택할 수 있지만 데이터는 하나의 구조로 전달되어야 합니다.
출력 버퍼 길이
유효한 출력 버퍼 크기 중 가장 작은 크기는 DWORD의 크기입니다.
드라이버가 DWORD 크기의 출력 버퍼를 수신하는 경우 드라이버는 작업을 완료하는 데 필요한 버퍼 크기를 즉시 반환해야 합니다. 필요한 버퍼 크기를 보내기 위해 살짝 밀기가 발생할 때까지 기다리지 마세요.
상태 블록
드라이버에 대한 DeviceIoControl 호출이 완료되고 OUT 페이로드가 유효한지 여부를 나타냅니다.
상태 멤버는 다음 표의 값 중 하나로 설정됩니다.
| 상태 값 | 묘사 |
|---|---|
| S_OK, STATUS_SUCCESS | 작업이 성공적으로 완료되었습니다. 반환되는 데이터 크기가 DWORD이면 페이로드에 호출에 필요한 버퍼의 크기가 포함됩니다. 그렇지 않으면 페이로드에 전체 출력 버퍼가 포함됩니다. |
| E_INVALIDARG | 매개 변수가 올바르게 지정되지 않았습니다. |
| WINBIO_E_DATA_COLLECTION_IN_PROGRESS | 디바이스에 보류 중인 IOCTL_BIOMETRIC_CAPTURE_DATA 있습니다. |
| E_UNKNOWN | 페이로드가 채워지는 것을 방지하는 다른 모든 오류입니다. |
| E_UNEXPECTED | 페이로드가 채워지는 것을 방지하는 다른 모든 오류입니다. |
| E_FAIL | 페이로드가 채워지는 것을 방지하는 다른 모든 오류입니다. |
발언
언제든지 하나의 데이터 수집 IOCTL만 보류할 수 있습니다. 디바이스에 보류 중인 IOCTL_BIOMETRIC_CAPTURE_DATA 있는 경우 IOCTL_BIOMETRIC_CAPTURE_DATA WINBIO_E_DATA_COLLECTION_IN_PROGRESS 반환해야 합니다.
IOCTL_BIOMETRIC_CAPTURE_DATA 생체 인식 데이터 캡처가 발생할 때 완료되는 차단 데이터 수집 IOCTL입니다.
공급업체에서 제공하는 드라이버가 전체 페이로드를 다시 전달하는 경우 WINBIO_CAPTURE_DATA WinBioHresult 멤버를 생체 인식 작업의 상태로 채워야 합니다.
가능한 값은 다음과 같습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 이상 버전의 Windows에서 사용할 수 있습니다. |
| 헤더 | winbio_ioctl.h |