IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL (winbio_ioctl.h)

IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL 返回一个结构,其中包含传感器的一组属性。 供应商提供的 WBDI 驱动程序必须支持此 IOCTL。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

无。

输入缓冲区长度

无。

输出缓冲区

AssociatedIrpSystemBuffer 成员指向包含WINBIO_SENSOR_ATTRIBUTES结构的缓冲区。

输出缓冲区长度

最小有效输出缓冲区大小是 DWORD 的大小。 如果驱动程序收到 DWORD 大小的输出缓冲区,则驱动程序应返回所请求操作所需的缓冲区大小。

状态块

指示对驱动程序的 DeviceIoControl 调用已完成且 OUT 有效负载是否有效。

Status 成员设置为下表中的值之一。

状态值 说明
S_OK、STATUS_SUCCESS 操作已成功完成。 如果返回的数据大小为 DWORD,则有效负载包含调用所需的缓冲区大小。 否则,有效负载包含完整的输出缓冲区。
E_INVALIDARG 未正确指定参数。
E_UNKNOWN 阻止有效负载填充的任何其他故障。
E_UNEXPECTED 阻止有效负载填充的任何其他故障。
E_FAIL 阻止有效负载填充的任何其他故障。

注解

如果供应商提供的驱动程序传回整个有效负载,则应使用指示生物识别操作状态的 HRESULT 值填充 WINBIO_SENSOR_ATTRIBUTESWinBioHresult 成员。

要求

要求
最低受支持的客户端 在 Windows 7 和更高版本的 Windows 中可用。
标头 winbio_ioctl.h