struttura WINBIO_SENSOR_ATTRIBUTES (winbio_ioctl.h)
La struttura IOCTL_BIOMETRIC_GET_ATTRIBUTES restituisce la struttura WINBIO_SENSOR_ATTRIBUTES come output.
Sintassi
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;
Membri
PayloadSize
Valore DWORD che indica le dimensioni totali del payload, inclusa la struttura a lunghezza fissa e i dati delle variabili alla fine.
WinBioHresult
Valore HRESULT che indica che contiene i dettagli dello stato dell'operazione di I/O. Nella tabella seguente sono inclusi i valori possibili.
| Valore di stato | Descrizione |
|---|---|
| S_OK | Operazione completata correttamente. |
| HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR) | Il driver non è riuscito a raccogliere le informazioni necessarie dal dispositivo. |
WinBioVersion
Struttura di tipo WINBIO_VERSION che contiene una versione WBDI WinBio supportata dal driver. Per essere compatibile con il servizio WinBio, WinBioVersion deve contenere la stessa versione principale della versione principale corrente del servizio WinBio, oltre a una versione secondaria minore minore o uguale alla versione secondaria corrente del servizio WinBio.
SensorType
Maschera di bit DWORD di tipo WINBIO_BIOMETRIC_TYPE che contiene dati biometrici raccolti dal sensore. In Windows 7 è supportato solo WINBIO_TYPE_FINGERPRINT.
SensorSubType
Sottotipo WINBIO_BIOMETRIC_SENSOR_SUBTYPE che contiene informazioni aggiuntive sul sensore. Ad esempio, questo membro può specificare se il sensore richiede all'utente di toccare semplicemente il sensore o scorrere un dito sul sensore.
WINBIO_BIOMETRIC_SENSOR_SUBTYPE può contenere i valori nella tabella seguente.
| Valore del sottotipo biometrico | Descrizione |
|---|---|
| WINBIO_FP_SENSOR_SUBTYPE_SWIPE | Il dispositivo richiede all'utente di scorrere la punta del dito sul sensore. |
| WINBIO_FP_SENSOR_SUBTYPE_TOUCH | Il dispositivo richiede all'utente di posizionare l'intera impronta digitale su un riquadro del sensore. |
Capabilities
Sottotipo WINBIO_CAPABILITIES, che indica quali funzionalità sono supportate dal dispositivo.
WINBIO_CAPABILITIES può contenere i valori nella tabella seguente.
| Valore della funzionalità biometrica | Descrizione |
|---|---|
| WINBIO_CAPABILITY_SENSOR | Il dispositivo può raccogliere dati biometrici. |
| WINBIO_CAPABILITY_MATCHING | Il dispositivo può eseguire operazioni di corrispondenza. |
| WINBIO_CAPABILITY_STORAGE | Il dispositivo può archiviare modelli biometrici. |
| WINBIO_CAPABILITY_SECURE_STORAGE | Il dispositivo può archiviare dati sicuri associati a un modello. I dati sicuri vengono rilasciati solo con una corrispondenza positiva. Il dispositivo deve supportare almeno l'algoritmo SHA-1 per il calcolo hash sicuro da usare per archiviare i modelli nel pool di sistema. |
| WINBIO_CAPABILITY_PROCESSING | Il dispositivo può elaborare campioni e trasformarli in modelli biometrici. |
| WINBIO_CAPABILITY_ENCRYPTION | Il dispositivo supporta la crittografia di esempi e modelli. |
| WINBIO_CAPABILITY_SIGNING | Il dispositivo può firmare i dati acquisiti. |
| WINBIO_CAPABILITY_NAVIGATION | Il dispositivo può essere usato come dispositivo di spostamento. Alcuni dispositivi e driver possono acquisire dati in un formato che può essere convertito da un'applicazione in modalità utente in eventi di spostamento, in modo analogo a un mouse. |
| WINBIO_CAPABILITY_INDICATOR | Il dispositivo ha un indicatore che può essere attivato o disattivato. |
| WINBIO_CAPABILITY_VIRTUAL_SENSOR | L'adattatore sensore gestisce la propria connessione all'hardware biometrico. Nota: Questa costante si applica solo per Windows 10 e versioni successive. |
| WINBIO_CAPABILITY_SECURE_SENSOR | Il dispositivo supporta i metodi di sicurezza disponibili nell'interfaccia dell'adattatore del motore WinBio versione 4.0 o successiva. Nota: Questa costante si applica solo per Windows 10 e versioni successive. |
ManufacturerName
Struttura di tipo WINBIO_STRING che contiene il nome del produttore del dispositivo.
ModelName
Struttura di tipo WINBIO_STRING che contiene il nome del modello di dispositivo.
SerialNumber
Struttura di tipo WINBIO_STRING che contiene il numero di serie del dispositivo, se presente.
FirmwareVersion
Struttura di tipo WINBIO_VERSION che contiene la versione del firmware caricato nel dispositivo.
SupportedFormatEntries
Numero di formati supportati dal driver e dal dispositivo. Deve essere presente almeno uno, ovvero il formato standard di Windows.
SupportedFormat[1]
Struttura di tipo WINBIO_REGISTERED_FORMAT che contiene un elenco dei formati supportati dal driver e dal dispositivo.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| intestazione | winbio_ioctl.h |