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.miembro de 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 estar en 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 Estado de se establece en uno de los valores de la tabla siguiente.
| Valor de estado | Descripción |
|---|---|
| S_OK, STATUS_SUCCESS | La operación se completó 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. |
Observaciones
Solo un IOCTL de recopilación de datos puede estar pendiente en cualquier momento. Si el dispositivo tiene una 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 pasa toda la carga útil, debe rellenar el winBioHresult miembro de WINBIO_CAPTURE_DATA con el estado de la operación biométrica.
Entre los valores posibles se incluyen:
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 7 y versiones posteriores de Windows. |
| encabezado de | winbio_ioctl.h |