Função WbioQuerySensorInterface (winbio_adapter.h)

  • Artigo

Recupera um ponteiro para a estrutura WINBIO_SENSOR_INTERFACE do adaptador do sensor.

Sintaxe

HRESULT WbioQuerySensorInterface(
  [out] PWINBIO_SENSOR_INTERFACE *SensorInterface
);

Parâmetros

[out] SensorInterface

Endereço de uma variável que recebe um ponteiro para a estrutura WINBIO_SENSOR_INTERFACE .

Valor retornado

Se a função for bem-sucedida, ela retornará S_OK. Se a função falhar, ela deverá retornar um dos seguintes valores HRESULT para indicar o erro.

Código de retorno Descrição
E_POINTER
 O parâmetro SensorInterface não pode ser NULL.

Comentários

A Estrutura Biométrica do Windows chama essa função depois de carregar uma DLL do adaptador de sensor na memória. Cada DLL do adaptador de sensor deve, portanto, implementar e exportar a função WbioQueryEngineInterface . O nome da função diferencia maiúsculas de minúsculas e sua ortografia e assinatura devem corresponder exatamente à descrição fornecida na seção Sintaxe.

Para ficar visível para a Estrutura Biométrica do Windows, a função WbioQueryEngineInterface deve ser nomeada na seção EXPORTS do arquivo de comando do vinculador de definição de exportação para a DLL.

Exemplos

O pseudocódigo a seguir mostra uma implementação possível dessa função.

HRESULT
WINAPI
WbioQuerySensorInterface(
    __out PWINBIO_SENSOR_INTERFACE *SensorInterface
    )
{
    // g_SensorInterface is a global variable.
    *SensorInterface = &g_SensorInterface;
    return S_OK;
}

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbio_adapter.h (inclua Winbio_adapter.h)

Confira também

Funções de plug-in