IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS IOCTL (winbio_ioctl.h)
O IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS IOCTL recupera uma lista de algoritmos de hash criptográficos compatíveis com o dispositivo. Este IOCTL é opcional.
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 WINBIO_SUPPORTED_ALGORITHMS .
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 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
Os algoritmos são especificados usando cadeias de caracteres codificadas em UTF-8 terminadas em NULL. As cadeias de caracteres "OID" do identificador de algoritmo são definidas em RFC 3279 e RFC 3278 .
Aqui estão exemplos de cadeias de caracteres OID para algoritmos de hash.
| Algoritmo | Cadeia de caracteres do identificador de algoritmo |
|---|---|
| SHA-1 | "1.3.14.3.2.26" |
| SHA-256 | "2.16.840.1.101.3.4.2.1" |
| SHA-384 | "2.16.840.1.101.3.4.2.2" |
| SHA-512 | "2.16.840.1.101.3.4.2.3" |
IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS deve ser implementado se o dispositivo der suporte a WINBIO_CAPABILITY_SECURE_STORAGE. O dispositivo deve dar suporte a pelo menos SHA-1 ("1.3.14.3.2.26") para ser usado para armazenar modelos do WinBio.
Se o driver fornecido pelo fornecedor retornar toda a carga, ele deverá preencher o membro WinBioHresult do WINBIO_SUPPORTED_ALGORITHMS 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 |