IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS IOCTL(winbio_ioctl.h)

IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS IOCTL은 디바이스에서 지원하는 암호화 해시 알고리즘 목록을 검색합니다. 이 IOCTL은 선택 사항입니다.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

없음.

입력 버퍼 길이

없음.

출력 버퍼

AssociatedIrp.SystemBuffer 멤버는 WINBIO_SUPPORTED_ALGORITHMS 구조체가 포함된 버퍼를 가리킵니다.

출력 버퍼 길이

유효한 출력 버퍼 크기 중 가장 작은 크기는 DWORD의 크기입니다. 드라이버가 DWORD 크기의 출력 버퍼를 수신하는 경우 드라이버는 요청된 작업에 필요한 버퍼 크기를 반환해야 합니다.

상태 블록

드라이버에 대한 DeviceIoControl 호출이 완료되고 OUT 페이로드가 유효한지 여부를 나타냅니다.

상태 멤버는 다음 표의 값 중 하나로 설정됩니다.

상태 값	묘사
S_OK, STATUS_SUCCESS	작업이 성공적으로 완료되었습니다. 반환되는 데이터 크기가 DWORD이면 페이로드에 호출에 필요한 버퍼의 크기가 포함됩니다. 그렇지 않으면 페이로드에 전체 출력 버퍼가 포함됩니다.
E_INVALIDARG	매개 변수가 올바르게 지정되지 않았습니다.
E_UNKNOWN	페이로드가 채워지는 것을 방지하는 다른 모든 오류입니다.
E_UNEXPECTED	페이로드가 채워지는 것을 방지하는 다른 모든 오류입니다.
E_FAIL	페이로드가 채워지는 것을 방지하는 다른 모든 오류입니다.

발언

알고리즘은 NULL로 종료된 UTF-8로 인코딩된 문자열을 사용하여 지정됩니다. 알고리즘 식별자 "OID" 문자열은 RFC 3279 및 RFC 3278 정의됩니다.

해시 알고리즘에 대한 OID 문자열의 예는 다음과 같습니다.

알고리즘	알고리즘 식별자 문자열
SHA-1	"1.3.14.3.2.26"
SHA-256	"2.16.840.1.101.3.4.2.1"
SHA-384	"2.16.840.1.101.3.4.2.2"
SHA-512	"2.16.840.1.101.3.4.2.3"

디바이스에서 WINBIO_CAPABILITY_SECURE_STORAGE 지원하는 경우 IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS 구현해야 합니다. 디바이스는 WinBio 템플릿을 저장하는 데 사용할 SHA-1("1.3.14.3.2.26") 이상을 지원해야 합니다.

공급업체에서 제공하는 드라이버가 전체 페이로드를 다시 전달하는 경우 WINBIO_SUPPORTED_ALGORITHMSWinBioHresult 멤버를 생체 인식 작업 상태로 채워야 합니다.

가능한 값은 다음과 같습니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 7 이상 버전의 Windows에서 사용할 수 있습니다.
헤더	winbio_ioctl.h