estrutura WINBIO_SENSOR_ATTRIBUTES (winbio_ioctl.h)
A estrutura IOCTL_BIOMETRIC_GET_ATTRIBUTES retorna a estrutura WINBIO_SENSOR_ATTRIBUTES como saída.
Sintaxe
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;
Membros
PayloadSize
Um valor DWORD que indica o tamanho total da carga, incluindo a estrutura de comprimento fixo e quaisquer dados variáveis no final.
WinBioHresult
Um valor HRESULT que indica que contém status detalhes da operação de E/S. A tabela a seguir inclui valores possíveis.
| Valor de status | Descrição |
|---|---|
| S_OK | A operação foi concluída com sucesso. |
| HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR) | O driver não pôde coletar as informações necessárias do dispositivo. |
WinBioVersion
Uma estrutura do tipo WINBIO_VERSION que contém uma versão WBDI do WinBio compatível com o driver. Para ser compatível com o serviço WinBio, o WinBioVersion deve conter a mesma versão principal da versão principal atual do serviço WinBio, além de uma versão secundária menor ou igual à versão secundária atual do serviço WinBio.
SensorType
Uma máscara de bits DWORD do tipo WINBIO_BIOMETRIC_TYPE que contém dados biométricos coletados pelo sensor. No Windows 7, há suporte apenas para WINBIO_TYPE_FINGERPRINT.
SensorSubType
Um subtipo WINBIO_BIOMETRIC_SENSOR_SUBTYPE que contém informações adicionais sobre o sensor. Por exemplo, esse membro pode especificar se o sensor exige que o usuário simplesmente toque no sensor ou passe um dedo sobre o sensor.
WINBIO_BIOMETRIC_SENSOR_SUBTYPE pode conter os valores na tabela a seguir.
| Valor de subtipo biométrico | Descrição |
|---|---|
| WINBIO_FP_SENSOR_SUBTYPE_SWIPE | O dispositivo exige que o usuário passe o dedo sobre o sensor. |
| WINBIO_FP_SENSOR_SUBTYPE_TOUCH | O dispositivo exige que o usuário coloque toda a impressão digital em um sensor. |
Capabilities
Um subtipo WINBIO_CAPABILITIES, que indica quais recursos são compatíveis com o dispositivo.
WINBIO_CAPABILITIES pode conter os valores na tabela a seguir.
| Valor da funcionalidade biométrica | Descrição |
|---|---|
| WINBIO_CAPABILITY_SENSOR | O dispositivo pode coletar dados biométricos. |
| WINBIO_CAPABILITY_MATCHING | O dispositivo pode executar operações de correspondência. |
| WINBIO_CAPABILITY_STORAGE | O dispositivo pode armazenar modelos biométricos. |
| WINBIO_CAPABILITY_SECURE_STORAGE | O dispositivo pode armazenar dados seguros associados a um modelo. Os dados seguros só são liberados com uma correspondência positiva. O dispositivo deve dar suporte pelo menos ao algoritmo SHA-1 para que a computação de hash segura seja usada para armazenar modelos no pool do sistema. |
| WINBIO_CAPABILITY_PROCESSING | O dispositivo pode processar exemplos e transformá-los em modelos biométricos. |
| WINBIO_CAPABILITY_ENCRYPTION | O dispositivo dá suporte à criptografia de exemplos e modelos. |
| WINBIO_CAPABILITY_SIGNING | O dispositivo pode assinar dados capturados. |
| WINBIO_CAPABILITY_NAVIGATION | O dispositivo pode ser usado como um dispositivo de navegação. Alguns dispositivos e drivers podem capturar dados em um formato que pode ser traduzido por um aplicativo do modo de usuário em eventos de navegação, assim como um mouse. |
| WINBIO_CAPABILITY_INDICATOR | O dispositivo tem um indicador que pode ser ativado ou desativado. |
| WINBIO_CAPABILITY_VIRTUAL_SENSOR | O adaptador de sensor gerencia sua própria conexão com o hardware biométrico. Nota: Essa constante se aplica somente a Windows 10 e posteriores. |
| WINBIO_CAPABILITY_SECURE_SENSOR | O dispositivo dá suporte a métodos de segurança disponíveis na interface do adaptador do mecanismo WinBio versão 4.0 ou posterior. Nota: Essa constante se aplica somente a Windows 10 e posteriores. |
ManufacturerName
Uma estrutura do tipo WINBIO_STRING que contém o nome do fabricante do dispositivo.
ModelName
Uma estrutura do tipo WINBIO_STRING que contém o nome do modelo de dispositivo.
SerialNumber
Uma estrutura do tipo WINBIO_STRING que contém o número de série do dispositivo, se houver.
FirmwareVersion
Uma estrutura do tipo WINBIO_VERSION que contém a versão do firmware que é carregada no dispositivo.
SupportedFormatEntries
O número de formatos compatíveis com o driver e o dispositivo. Deve haver pelo menos um, que é o formato padrão do Windows.
SupportedFormat[1]
Uma estrutura do tipo WINBIO_REGISTERED_FORMAT que contém uma lista dos formatos compatíveis com o driver e o dispositivo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 7 e versões posteriores do Windows. |
| Cabeçalho | winbio_ioctl.h |