estrutura WINBIO_CAPTURE_DATA (winbio_ioctl.h)
O IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL retorna a estrutura WINBIO_CAPTURE_DATA como saída.
Sintaxe
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;
Membros
PayloadSize
O tamanho total da carga. Isso inclui a estrutura de comprimento fixo e todos os dados de variáveis no final.
WinBioHresult
O status detalhes da operação de E/S. É aqui que os códigos de informações e erro WINBIO serão passados. A tabela a seguir mostra valores possíveis para esse membro.
| Valor de status | Descrição |
|---|---|
| S_OK | A operação foi concluída com sucesso. |
| WINBIO_E_DATA_COLLECTION_IN_PROGRESS | Já há uma IOCTL de coleta de dados pendente. |
| WINBIO_E_UNSUPPORTED_DATA_FORMAT | Não há suporte para o formato especificado por esse driver e dispositivo. |
| WINBIO_E_UNSUPPORTED_DATA_TYPE | Não há suporte para o tipo de dados solicitado por esse driver e dispositivo. |
| WINBIO_E_INVALID_DEVICE_STATE | O dispositivo não pôde ser colocado no modo de captura biométrica. Isso pode ocorrer porque o dispositivo está em outro modo de coleta que não seja de dados. |
| HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR) | A operação não foi concluída devido a um erro do dispositivo. |
| WINBIO_E_DEVICE_BUSY | O dispositivo está no meio de uma operação específica do fornecedor. |
| WINBIO_E_CANCELED | A operação foi cancelada pelo chamador ou uma solicitação de IOCTL_BIOMETRIC_RESET. |
| WINBIO_E_UNSUPPORTED_PURPOSE | Não há suporte para a finalidade de captura especificada pelo driver. |
SensorStatus
O WINBIO_SENSOR_STATUS status do sensor após a captura. Ele especifica o status operacional do sensor.
WINBIO_SENSOR_STATUS pode ser consultado a qualquer momento. Quando WINBIO_SENSOR_STATUS é retornado após uma conclusão de E/S de captura, indica se uma captura foi bem-sucedida. Os valores possíveis são mostrados na tabela a seguir.
| Código de status do sensor | Descrição |
|---|---|
| WINBIO_SENSOR_ACCEPT | O sensor concluiu com êxito uma operação de captura. Isso só deve ser retornado imediatamente após uma operação de captura. Em seguida, o sensor retornará ao WINBIO_SENSOR_READY ou WINBIO_SENSOR_BUSY. |
| WINBIO_SENSOR_REJECT | O sensor rejeitou a operação de captura anterior. Isso só deve ser retornado imediatamente após uma operação de captura. Em seguida, o sensor retornará ao WINBIO_SENSOR_READY ou WINBIO_SENSOR_BUSY. |
| WINBIO_SENSOR_READY | O sensor está pronto para capturar dados. Se houver uma IOCTL de captura de dados pendente, o sensor estará pronto para aceitar dados. |
| WINBIO_SENSOR_BUSY | O sensor está ocupado ou em um estado em que não pode capturar dados. Por exemplo, o dispositivo ainda pode estar inicializando depois de ser ativado. |
| WINBIO_SENSOR_NOT_CALIBRATED | O sensor deve ser calibrado antes de ser colocado no modo de coleta de dados. |
| WINBIO_SENSOR_FAILURE | O dispositivo do sensor falhou. |
RejectDetail
Se o sensor status foi WINBIO_SENSOR_REJECT, esse membro contém um valor WINBIO_REJECT_DETAIL. WINBIO_SENSOR_REJECT especifica o motivo pelo qual uma operação de amostragem biométrica falhou.
#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
Uma estrutura do tipo WINBIO_DATA que contém dados capturados pelo dispositivo, do formato especificado. O membro da matriz de dados da estrutura WINBIO_DATA deve conter uma estrutura WINBIO_BIR .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 7 e versões posteriores do Windows. |
| Cabeçalho | winbio_ioctl.h |