IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL (winbio_ioctl.h)
O IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL orienta o driver a recuperar a próxima verificação de dados biométricos. Essa chamada deve colocar o dispositivo no modo de captura. Os drivers WBDI fornecidos pelo fornecedor devem dar suporte a IOCTL_BIOMETRIC_CAPTURE_DATA.
Código principal
Buffer de entrada
Comprimento do buffer de entrada
O comprimento de uma estrutura WINBIO_CAPTURE_PARAMETERS .
Buffer de saída
O AssociatedIrp. O membro SystemBuffer aponta para um buffer que contém uma estrutura WINBIO_CAPTURE_DATA .
Os dados específicos do fornecedor na estrutura WINBIO_BIR podem estar em qualquer formato que o fornecedor gostaria de coletar do driver. Os fornecedores podem optar por processar dados no driver WBDI ou no adaptador do mecanismo, mas os dados devem ser passados em uma estrutura.
Comprimento do buffer de saída
O menor tamanho de buffer de saída válido é o tamanho do DWORD.
Se o driver receber um buffer de saída do tamanho DWORD, o driver deverá retornar imediatamente o tamanho do buffer necessário para concluir a operação. Não espere que o dedo ocorra para enviar o tamanho do buffer necessário.
Bloco de status
Indica se a chamada DeviceIoControl para o driver foi concluída e a carga OUT é válida.
O membro Status é definido como um dos valores na tabela a seguir.
Valor de status | Descrição |
---|---|
S_OK, STATUS_SUCCESS | A operação foi concluída com sucesso. Se o tamanho dos dados retornados for DWORD, o conteúdo conterá o tamanho do buffer necessário para a chamada. Caso contrário, o conteúdo contém o buffer de saída completo. |
E_INVALIDARG | Os parâmetros não foram especificados corretamente. |
WINBIO_E_DATA_COLLECTION_IN_PROGRESS | O dispositivo tem um IOCTL_BIOMETRIC_CAPTURE_DATA pendente. |
E_UNKNOWN | Qualquer outra falha que impeça que o conteúdo seja preenchido. |
E_UNEXPECTED | Qualquer outra falha que impeça que o conteúdo seja preenchido. |
E_FAIL | Qualquer outra falha que impeça que o conteúdo seja preenchido. |
Comentários
Somente uma IOCTL de coleta de dados pode estar pendente a qualquer momento. Se o dispositivo tiver um IOCTL_BIOMETRIC_CAPTURE_DATA pendente, IOCTL_BIOMETRIC_CAPTURE_DATA deverá retornar WINBIO_E_DATA_COLLECTION_IN_PROGRESS.
IOCTL_BIOMETRIC_CAPTURE_DATA é um IOCTL de coleta de dados de bloqueio que é concluído quando ocorre a captura biométrica de dados.
Se o driver fornecido pelo fornecedor retornar toda a carga, ele deverá preencher o membro WinBioHresult do WINBIO_CAPTURE_DATA com o status da operação Biométrica.
Os valores possíveis incluem:
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível no Windows 7 e versões posteriores do Windows. |
Cabeçalho | winbio_ioctl.h |