IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL(winbio_ioctl.h)
IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL은 센서에 대한 특성 집합을 포함하는 구조를 반환합니다. 공급업체에서 제공하는 WBDI 드라이버는 이 IOCTL을 지원해야 합니다.
주 코드
입력 버퍼
없음
입력 버퍼 길이
없음
출력 버퍼
AssociatedIrp입니다. SystemBuffer 멤버는 WINBIO_SENSOR_ATTRIBUTES 구조체가 포함된 버퍼를 가리킵니다.
출력 버퍼 길이
가장 작은 유효한 출력 버퍼 크기는 DWORD의 크기입니다. 드라이버가 DWORD 크기의 출력 버퍼를 수신하는 경우 드라이버는 요청된 작업에 필요한 버퍼 크기를 반환해야 합니다.
상태 블록
드라이버에 대한 DeviceIoControl 호출이 완료되고 OUT 페이로드가 유효한지 여부를 나타냅니다.
Status 멤버는 다음 표의 값 중 하나로 설정됩니다.
| 상태 값 | Description |
|---|---|
| S_OK, STATUS_SUCCESS | 작업이 성공적으로 완료되었습니다. 반환되는 데이터 크기가 DWORD인 경우 페이로드에는 호출에 필요한 버퍼의 크기가 포함됩니다. 그렇지 않으면 페이로드에 전체 출력 버퍼가 포함됩니다. |
| E_INVALIDARG | 매개 변수가 올바르게 지정되지 않았습니다. |
| E_UNKNOWN | 페이로드가 채워지는 것을 방지하는 다른 모든 오류입니다. |
| E_UNEXPECTED | 페이로드가 채워지는 것을 방지하는 다른 모든 오류입니다. |
| E_FAIL | 페이로드가 채워지는 것을 방지하는 다른 모든 오류입니다. |
설명
공급업체에서 제공하는 드라이버가 전체 페이로드를 다시 전달하는 경우 생체 인식 작업의 상태 나타내는 HRESULT 값으로 WINBIO_SENSOR_ATTRIBUTESWinBioHresult 멤버를 채워야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다. |
| 머리글 | winbio_ioctl.h |