Compartir a través de

estructura WINBIO_CAPTURE_DATA (winbio_ioctl.h)

  • Artículo

El IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL devuelve la estructura WINBIO_CAPTURE_DATA como salida.

Sintaxis

typedef struct _WINBIO_CAPTURE_DATA {
  DWORD                PayloadSize;
  HRESULT              WinBioHresult;
  WINBIO_SENSOR_STATUS SensorStatus;
  WINBIO_REJECT_DETAIL RejectDetail;
  WINBIO_DATA          CaptureData;
} WINBIO_CAPTURE_DATA, *PWINBIO_CAPTURE_DATA;

Miembros

PayloadSize

Tamaño total de la carga. Esto incluye la estructura de longitud fija y los datos de variables al final.

WinBioHresult

Detalle de estado de la operación de E/S. Aquí es donde se pasarán códigos de información y error winBIO. En la tabla siguiente se muestran los valores posibles para este miembro.

Valor de estado Descripción
S_OK La operación se completó correctamente.
WINBIO_E_DATA_COLLECTION_IN_PROGRESS Ya hay un IOCTL de recopilación de datos pendiente.
WINBIO_E_UNSUPPORTED_DATA_FORMAT Este controlador y dispositivo no admiten el formato especificado.
WINBIO_E_UNSUPPORTED_DATA_TYPE Este controlador y dispositivo no admiten el tipo de datos solicitados.
WINBIO_E_INVALID_DEVICE_STATE El dispositivo no se pudo poner en modo de captura biométrica. Esto podría deberse a que el dispositivo está en otro modo de recopilación de datos.
HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR) La operación no se completó debido a un error del dispositivo.
WINBIO_E_DEVICE_BUSY El dispositivo está en medio de una operación específica del proveedor.
WINBIO_E_CANCELED El autor de la llamada canceló la operación o una solicitud de IOCTL_BIOMETRIC_RESET.
WINBIO_E_UNSUPPORTED_PURPOSE El controlador no admite el propósito de captura especificado.

SensorStatus

El WINBIO_SENSOR_STATUS estado del sensor después de que se haya producido la captura. Especifica el estado de funcionamiento del sensor.

WINBIO_SENSOR_STATUS se pueden consultar en cualquier momento. Cuando se devuelve WINBIO_SENSOR_STATUS tras una finalización de E/S de captura, indica si una captura se realizó correctamente. Los valores posibles se muestran en la tabla siguiente.

Código de estado del sensor Descripción
WINBIO_SENSOR_ACCEPT El sensor acaba de completar correctamente una operación de captura. Esto solo debe devolverse inmediatamente después de una operación de captura. A continuación, el sensor volverá a WINBIO_SENSOR_READY o WINBIO_SENSOR_BUSY.
WINBIO_SENSOR_REJECT El sensor rechazó la operación de captura anterior. Esto solo debe devolverse inmediatamente después de una operación de captura. A continuación, el sensor volverá a WINBIO_SENSOR_READY o WINBIO_SENSOR_BUSY.
WINBIO_SENSOR_READY El sensor está listo para capturar datos. Si hay un IOCTL de captura de datos pendiente, el sensor está listo para aceptar datos.
WINBIO_SENSOR_BUSY El sensor está ocupado o está en un estado en el que no puede capturar datos. Por ejemplo, el dispositivo todavía podría inicializarse después de que se haya activado.
WINBIO_SENSOR_NOT_CALIBRATED El sensor debe calibrarse antes de que se ponga en modo de recopilación de datos.
WINBIO_SENSOR_FAILURE Error en el dispositivo del sensor.

RejectDetail

Si se WINBIO_SENSOR_REJECT el estado del sensor, este miembro contiene un valor de WINBIO_REJECT_DETAIL. WINBIO_SENSOR_REJECT especifica el motivo por el que se produjo un error en una operación de muestreo biométrico.

Los valores importantes de definidos para Windows 7 son solo para detalles de rechazo de huellas digitales.
 
Entre los valores detallados del error para WINBIO_TYPE_FINGERPRINT se incluyen: 
#define WINBIO_FP_TOO_HIGH          ((WINBIO_REJECT_DETAIL)1)
#define WINBIO_FP_TOO_LOW           ((WINBIO_REJECT_DETAIL)2)
#define WINBIO_FP_TOO_LEFT          ((WINBIO_REJECT_DETAIL)3)
#define WINBIO_FP_TOO_RIGHT         ((WINBIO_REJECT_DETAIL)4)
#define WINBIO_FP_TOO_FAST          ((WINBIO_REJECT_DETAIL)5)
#define WINBIO_FP_TOO_SLOW          ((WINBIO_REJECT_DETAIL)6)
#define WINBIO_FP_POOR_QUALITY      ((WINBIO_REJECT_DETAIL)7)
#define WINBIO_FP_TOO_SKEWED        ((WINBIO_REJECT_DETAIL)8)
#define WINBIO_FP_TOO_SHORT         ((WINBIO_REJECT_DETAIL)9)
#define WINBIO_FP_MERGE_FAILURE     ((WINBIO_REJECT_DETAIL)10)

CaptureData

Estructura de tipo WINBIO_DATA que contiene los datos capturados por el dispositivo, del formato especificado. El miembro de matriz data de la estructura WINBIO_DATA debe contener una estructura WINBIO_BIR.

Requisitos

Requisito Valor
cliente mínimo admitido Disponible en Windows 7 y versiones posteriores de Windows.
encabezado de winbio_ioctl.h

Consulte también

IOCTL_BIOMETRIC_CAPTURE_DATA