Partilhar via


Códigos de controle personalizados

Os fornecedores podem definir códigos de controle personalizados a partir de 0x800.

Para definir códigos de controle de E/S específicos do fornecedor, use a macro CTL_CODE fornecida pelo sistema com os seguintes argumentos:

#define IOCTL_BIOMETRIC_Device_Function CTL_CODE(FILE_DEVICE_BIOMETRIC, Function, METHOD_BUFFERED, FILE_ANY_ACCESS)

Todos os parâmetros de entrada/saída são definidos pelo fornecedor. 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.

IOCTLs definidos pelo fornecedor podem ser usados para qualquer operação específica do fornecedor. Essas chamadas vêm por meio do Serviço Biométrico do Windows, que tem controle exclusivo do dispositivo. Aqui estão alguns exemplos de como os fornecedores podem usar os IOCTLs específicos do fornecedor:

  • Configure sessões seguras proprietárias entre um aplicativo ou componente e o dispositivo.
  • Interface com funcionalidades de correspondência e armazenamento no dispositivo de um plug-in de banco de dados ou mecanismo WinBio.
  • E/S pendente para eventos de dispositivo específicos do fornecedor.
  • Gerenciar sessões específicas do fornecedor.

Esse recurso está disponível no Windows 7 e versões posteriores do Windows.