PIBIO_ENGINE_IDENTIFY_ALL_FN função de retorno de chamada (winbio_adapter.h)

Chamado pela Estrutura Biométrica do Windows para determinar as identidades de qualquer pessoa que esteja atualmente no quadro da câmera.

Sintaxe

PIBIO_ENGINE_IDENTIFY_ALL_FN PibioEngineIdentifyAllFn;

HRESULT PibioEngineIdentifyAllFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PSIZE_T PresenceCount,
  [out]     PWINBIO_PRESENCE *PresenceArray
)
{...}

Parâmetros

[in, out] Pipeline

Ponteiro para a estrutura WINBIO_PIPELINE associada à unidade biométrica que executa a operação.

[out] PresenceCount

Endereço de uma variável que recebe o número de presenças detectadas pela função.

[out] PresenceArray

Endereço de uma variável que recebe um ponteiro para uma matriz de elementos WINBIO_PRESENCE .

Retornar valor

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_some_error
Qualquer código de erro fará com que o Serviço Biométrico registre o erro e ignore o quadro da câmera.

Comentários

O serviço biométrico chama esse método depois de enviar um novo quadro de dados para o adaptador do mecanismo.

Depois de processar o quadro de dados, essa função deve retornar um elemento WINBIO_PRESENCE para cada presença detectada no quadro de dados.

Caso a função EngineAdapterIdentifyAll não encontre rostos no quadro, ela retornará um HRESULT de S_OK e definirá os parâmetros de retorno PresenceCount e PresenceArray como zero e NULL, respectivamente. Em outras palavras, um quadro que não contém nenhuma presença humana não é uma condição de erro.

A única vez que EngineAdapterIdentifyAll deve retornar um HRESULT diferente de S_OK é se ele não quiser que o serviço bio use o quadro para atualizar o estado do Monitor de Presença. Isso deve ser uma ocorrência rara. O adaptador do mecanismo é responsável por alocar a matriz de elementos WINBIO_PRESENCE que retorna no parâmetro PresenceArray . Ele deve alocar essa memória do heap de processo usando a função HeapAlloc . Depois que a matriz é criada, ela se torna a propriedade da Estrutura Biométrica do Windows. Como o Framework desaloca essa memória depois de usá-la, o adaptador do mecanismo não deve tentar desalocar a matriz nem salvar um ponteiro nela. A falha ao seguir essa regra levará à corrupção de heap e a possíveis falhas do serviço biométrico.

Os valores dos itens de WINBIO_PRESENCE individuais no PresenceArray determinarão os eventos gerados para aplicativos cliente. Confira a discussão sobre a estrutura de WINBIO_PRESENCE para obter detalhes.

Requisitos

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