IOCTL_BIOMETRIC_CALIBRATE IOCTL (winbio_ioctl.h)

O IOCTL_BIOMETRIC_CALIBRATE IOCTL orienta o driver a executar todas as etapas necessárias para calibrar o dispositivo para uso. Internamente, o driver também pode coletar e retornar dados de calibragem específicos do fornecedor a serem analisados por um aplicativo. Os drivers WBDI fornecidos pelo fornecedor devem dar suporte a esse IOCTL.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum.

Comprimento do buffer de entrada

Nenhum.

Buffer de saída

O AssociatedIrp .membro SystemBuffer aponta para um buffer que contém uma estrutura de WINBIO_CALIBRATION_INFO.

Comprimento do buffer de saída

Comprimento de uma estrutura WINBIO_CALIBRATION_INFO.

O driver fornecido pelo fornecedor pode, opcionalmente, retornar um buffer do tamanho de DWORD que especifica o tamanho do buffer necessário para a operação solicitada.

Bloco de status

Indica se a chamada DeviceIoControl para o driver foi concluída e se o conteúdo OUT é válido.

O membro status é definido como um dos valores na tabela a seguir.

Valor do status	Descrição
S_OK, STATUS_SUCCESS	A operação foi concluída com êxito. 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.
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.

Observações

Se o driver fornecido pelo fornecedor passar todo o conteúdo, ele deverá preencher o WinBioHresult membro do WINBIO_CALIBRATION_INFO com o status da operação Biométrica.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 7 e versões posteriores do Windows.
cabeçalho	winbio_ioctl.h