IOCTL_BIOMETRIC_UPDATE_FIRMWARE IOCTL(winbio_ioctl.h)

IOCTL_BIOMETRIC_UPDATE_FIRMWARE IOCTL은 지정된 펌웨어 이미지로 디바이스의 펌웨어를 업데이트하도록 드라이버에 지시합니다. 이 IOCTL은 선택 사항입니다.

WINBIO_UPDATE_FIRMWARE 구조체의 길이입니다.

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

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

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

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

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

발언

펌웨어 이미지는 각 공급업체와 관련이 있으며 펌웨어 데이터와 드라이버가 이미지의 유효성을 검사하는 데 필요한 추가 데이터를 모두 포함할 수 있습니다.

디바이스에 다른 펌웨어 업데이트 메커니즘이 있는 경우 드라이버는 이 IOCTL에 대한 E_NOTIMPL 반환할 수 있습니다.

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

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

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