IOCTL_BIOMETRIC_RESET IOCTL (winbio_ioctl.h)
O IOCTL_BIOMETRIC_RESET IOCTL redefine o dispositivo para um estado conhecido ou ocioso, de acordo com o estado de energia atual. Os drivers WBDI fornecidos pelo fornecedor devem dar suporte a esse IOCTL.
Código principal
Buffer de entrada
Nenhum.
Comprimento do buffer de entrada
Nenhum.
Buffer de saída
O AssociatedIrp. O membro SystemBuffer aponta para um buffer que contém uma estrutura de WINBIO_BLANK_PAYLOAD .
Comprimento do buffer de saída
O comprimento de uma estrutura WINBIO_BLANK_PAYLOAD .
O driver fornecido pelo fornecedor pode, opcionalmente, retornar um buffer do tamanho 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 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. |
| 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
IOCTL_BIOMETRIC_RESET cancela uma IOCTL de coleta de dados, se houver uma pendente. Se houver uma operação específica do fornecedor em andamento, o driver deverá cancelar a operação e redefinir o dispositivo sempre que possível.
Se o driver fornecido pelo fornecedor retornar toda a carga, ele deverá preencher o membro WinBioHresult do WINBIO_BLANK_PAYLOAD com o status da operação Biométrica.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 7 e versões posteriores do Windows. |
| Cabeçalho | winbio_ioctl.h |