estructura de WINBIO_SENSOR_ATTRIBUTES (winbio_ioctl.h)
La estructura IOCTL_BIOMETRIC_GET_ATTRIBUTES devuelve la estructura WINBIO_SENSOR_ATTRIBUTES como salida.
Sintaxis
typedef struct _WINBIO_SENSOR_ATTRIBUTES {
DWORD PayloadSize;
HRESULT WinBioHresult;
WINBIO_VERSION WinBioVersion;
WINBIO_BIOMETRIC_TYPE SensorType;
WINBIO_BIOMETRIC_SENSOR_SUBTYPE SensorSubType;
WINBIO_CAPABILITIES Capabilities;
WINBIO_STRING ManufacturerName;
WINBIO_STRING ModelName;
WINBIO_STRING SerialNumber;
WINBIO_VERSION FirmwareVersion;
DWORD SupportedFormatEntries;
WINBIO_REGISTERED_FORMAT SupportedFormat[1];
} WINBIO_SENSOR_ATTRIBUTES, *PWINBIO_SENSOR_ATTRIBUTES;
Miembros
PayloadSize
Valor DWORD que indica el tamaño total de la carga, incluida la estructura de longitud fija y los datos variables al final.
WinBioHresult
Valor HRESULT que indica que contiene los detalles de estado de la operación de E/S. En la tabla siguiente se incluyen los valores posibles.
| Valor de estado | Descripción |
|---|---|
| S_OK | La operación se ha completado correctamente. |
| HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR) | El controlador no pudo recopilar la información necesaria del dispositivo. |
WinBioVersion
Estructura de tipo WINBIO_VERSION que contiene una versión wbDI de WinBio compatible con el controlador. Para ser compatible con el servicio WinBio, WinBioVersion debe contener la misma versión principal que la versión principal actual del servicio WinBio, además de una versión secundaria menor que sea menor o igual que la versión secundaria actual del servicio WinBio.
SensorType
Máscara de bits DWORD de tipo WINBIO_BIOMETRIC_TYPE que contiene datos biométricos recopilados por el sensor. En Windows 7, solo se admite WINBIO_TYPE_FINGERPRINT.
SensorSubType
Subtipo WINBIO_BIOMETRIC_SENSOR_SUBTYPE que contiene información adicional sobre el sensor. Por ejemplo, este miembro podría especificar si el sensor requiere que el usuario simplemente toque el sensor o deslice un dedo sobre el sensor.
WINBIO_BIOMETRIC_SENSOR_SUBTYPE puede contener los valores de la tabla siguiente.
| Valor de subtipo biométrico | Descripción |
|---|---|
| WINBIO_FP_SENSOR_SUBTYPE_SWIPE | El dispositivo requiere que el usuario deslice el dedo sobre el sensor. |
| WINBIO_FP_SENSOR_SUBTYPE_TOUCH | El dispositivo requiere que el usuario coloque toda su huella digital en un panel del sensor. |
Capabilities
Un subtipo WINBIO_CAPABILITIES, que indica qué funcionalidades admite el dispositivo.
WINBIO_CAPABILITIES puede contener los valores de la tabla siguiente.
| Valor de funcionalidad biométrica | Descripción |
|---|---|
| WINBIO_CAPABILITY_SENSOR | El dispositivo puede recopilar datos biométricos. |
| WINBIO_CAPABILITY_MATCHING | El dispositivo puede realizar operaciones de coincidencia. |
| WINBIO_CAPABILITY_STORAGE | El dispositivo puede almacenar plantillas biométricas. |
| WINBIO_CAPABILITY_SECURE_STORAGE | El dispositivo puede almacenar datos seguros asociados a una plantilla. Los datos seguros solo se liberan con una coincidencia positiva. El dispositivo debe admitir al menos el algoritmo SHA-1 para el cálculo hash seguro que se usará para almacenar plantillas en el grupo de sistemas. |
| WINBIO_CAPABILITY_PROCESSING | El dispositivo puede procesar muestras y convertirlos en plantillas biométricas. |
| WINBIO_CAPABILITY_ENCRYPTION | El dispositivo admite el cifrado de ejemplos y plantillas. |
| WINBIO_CAPABILITY_SIGNING | El dispositivo puede firmar los datos capturados. |
| WINBIO_CAPABILITY_NAVIGATION | El dispositivo se puede usar como dispositivo de navegación. Algunos dispositivos y controladores pueden capturar datos en un formato que una aplicación en modo de usuario puede traducir en eventos de navegación, como un mouse. |
| WINBIO_CAPABILITY_INDICATOR | El dispositivo tiene un indicador que se puede activar o desactivar. |
| WINBIO_CAPABILITY_VIRTUAL_SENSOR | El adaptador del sensor administra su propia conexión con el hardware biométrico. Nota: Esta constante solo se aplica a Windows 10 y versiones posteriores. |
| WINBIO_CAPABILITY_SECURE_SENSOR | El dispositivo admite métodos de seguridad disponibles en la interfaz del adaptador del motor WinBio versión 4.0 o posterior. Nota: Esta constante solo se aplica a Windows 10 y versiones posteriores. |
ManufacturerName
Estructura de tipo WINBIO_STRING que contiene el nombre del fabricante del dispositivo.
ModelName
Estructura de tipo WINBIO_STRING que contiene el nombre del modelo de dispositivo.
SerialNumber
Estructura de tipo WINBIO_STRING que contiene el número de serie del dispositivo, si existe uno.
FirmwareVersion
Estructura de tipo WINBIO_VERSION que contiene la versión del firmware que se carga en el dispositivo.
SupportedFormatEntries
Número de formatos admitidos por el controlador y el dispositivo. Debe haber al menos uno, que es el formato estándar de Windows.
SupportedFormat[1]
Estructura de tipo WINBIO_REGISTERED_FORMAT que contiene una lista de los formatos admitidos por el controlador y el dispositivo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 7 y versiones posteriores de Windows. |
| Encabezado | winbio_ioctl.h |