Compartilhar via


IOCTL_BIOMETRIC_SET_INDICATOR IOCTL (winbio_ioctl.h)

O IOCTL_BIOMETRIC_SET_INDICATOR IOCTL orienta o driver a atualizar a status da luz indicadora. A luz pode ser ativada ou desligada. Este IOCTL é opcional. Esse IOCTL deverá ser implementado se o driver der suporte à funcionalidade de WINBIO_CAPABILITY_INDICATOR.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

WINBIO_SET_INDICATOR

Comprimento do buffer de entrada

Comprimento de uma estrutura WINBIO_SET_INDICATOR .

Buffer de saída

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

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 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 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 conterá 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.

Comentários

Se o driver fornecido pelo fornecedor devolver toda a carga, ele deverá preencher o membro WinBioHresult do WINBIO_BLANK_PAYLOAD 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