IOCTL_BIOMETRIC_GET_SENSOR_STATUS IOCTL (winbio_ioctl.h)

IOCTL_BIOMETRIC_GET_SENSOR_STATUS IOCTL 告知驱动程序执行任何必要的步骤来收集设备的当前运行状态。供应商提供的 WBDI 驱动程序必须支持此 IOCTL。

无。

无。

AssociatedIrp。SystemBuffer 成员指向包含WINBIO_DIAGNOSTICS结构的缓冲区。

WINBIO_DIAGNOSTICS 结构的长度。

供应商提供的驱动程序可以选择返回 DWORD 大小的缓冲区，该缓冲区指定请求的操作所需的缓冲区大小。

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

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

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

注解

如果供应商提供的驱动程序传回整个有效负载，它应使用生物识别操作的状态填充 WINBIO_DIAGNOSTICS 的 WinBioHresult 成员。

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