IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL (winbio_ioctl.h)
El IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL dirige al controlador para recuperar el siguiente examen de datos biométricos. Esta llamada debe poner el dispositivo en modo de captura. Los controladores WBDI suministrados por el proveedor deben admitir IOCTL_BIOMETRIC_CAPTURE_DATA.
Código principal
Búfer de entrada
Longitud del búfer de entrada
Longitud de una estructura de WINBIO_CAPTURE_PARAMETERS .
Búfer de salida
AssociatedIrp. El miembro SystemBuffer apunta a un búfer que contiene una estructura de WINBIO_CAPTURE_DATA.
Los datos específicos del proveedor de la estructura WINBIO_BIR pueden tener cualquier formato que el proveedor quiera recopilar del controlador. Los proveedores pueden elegir procesar datos en el controlador WBDI o en el adaptador del motor, pero los datos deben pasarse en una estructura.
Longitud del búfer de salida
El tamaño de búfer de salida más pequeño válido es el tamaño de DWORD.
Si el controlador recibe un búfer de salida de tamaño DWORD, el controlador debe devolver inmediatamente el tamaño del búfer necesario para completar la operación. No espere a que se produzca el deslizamiento para enviar el tamaño de búfer necesario.
Bloque de estado
Indica si la llamada DeviceIoControl al controlador se completó y la carga out es válida.
El miembro Status se establece en uno de los valores de la tabla siguiente.
| Valor de estado | Descripción |
|---|---|
| S_OK, STATUS_SUCCESS | La operación se ha completado correctamente. Si el tamaño de los datos devueltos es DWORD, la carga contiene el tamaño del búfer necesario para la llamada. De lo contrario, la carga contiene el búfer de salida completo. |
| E_INVALIDARG | Los parámetros no se especificaron correctamente. |
| WINBIO_E_DATA_COLLECTION_IN_PROGRESS | El dispositivo tiene un IOCTL_BIOMETRIC_CAPTURE_DATA pendiente. |
| E_UNKNOWN | Cualquier otro error que impida que la carga se rellene. |
| E_UNEXPECTED | Cualquier otro error que impida que la carga se rellene. |
| E_FAIL | Cualquier otro error que impida que la carga se rellene. |
Comentarios
Solo un IOCTL de recopilación de datos puede estar pendiente en cualquier momento. Si el dispositivo tiene un IOCTL_BIOMETRIC_CAPTURE_DATA pendiente, IOCTL_BIOMETRIC_CAPTURE_DATA debe devolver WINBIO_E_DATA_COLLECTION_IN_PROGRESS.
IOCTL_BIOMETRIC_CAPTURE_DATA es un IOCTL de recopilación de datos de bloqueo que se completa cuando se produce la captura de datos biométricos.
Si el controlador proporcionado por el proveedor devuelve toda la carga, debe rellenar el miembro WinBioHresult de WINBIO_CAPTURE_DATA con el estado de la operación biométrica.
Los valores posibles son:
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 7 y versiones posteriores de Windows. |
| Encabezado | winbio_ioctl.h |