estrutura WINBIO_SENSOR_ATTRIBUTES (winbio_ioctl.h)

  • Artigo

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

Confira também

IOCTL_BIOMETRIC_GET_ATTRIBUTES