Compartilhar via


IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL (winbio_ioctl.h)

O IOCTL_BIOMETRIC_GET_ATTRIBUTES IOCTL retorna uma estrutura que contém um conjunto de atributos para o sensor. 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_SENSOR_ATTRIBUTES.

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 de DWORD, o driver deverá retornar 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_SENSOR_ATTRIBUTES com um valor HRESULT que indica 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