estrutura WINBIO_EXTENDED_ENROLLMENT_STATUS

Contém informações adicionais sobre o status de um registro em andamento.

Sintaxe

typedef struct _WINBIO_EXTENDED_ENROLLMENT_STATUS {
  HRESULT                  TemplateStatus;
  WINBIO_REJECT_DETAIL     RejectDetail;
  ULONG                    PercentComplete;
  WINBIO_BIOMETRIC_TYPE    Factor;
  WINBIO_BIOMETRIC_SUBTYPE SubFactor;
  union {
    ULONG32 Null;
    struct {
      RECT BoundingBox;
      LONG Distance;
    } FacialFeatures;
    struct {
      ULONG GeneralSamples;
      ULONG Center;
      ULONG TopEdge;
      ULONG BottomEdge;
      ULONG LeftEdge;
      ULONG RightEdge;
    } Fingerprint;
    struct {
      RECT  EyeBoundingBox_1;
      RECT  EyeBoundingBox_2;
      POINT PupilCenter_1;
      POINT PupilCenter_2;
      LONG  Distance;
    } Iris;
    struct {
      ULONG32 Reserved;
    } Voice;
  } Specific;
} WINBIO_EXTENDED_ENROLLMENT_STATUS, *PWINBIO_EXTENDED_ENROLLMENT_STATUS;

Membros

TemplateStatus

O status da coleção de exemplo para o modelo de registro. Os valores a seguir são possíveis para esse membro.

Valor Significado
S_OK
O registro está pronto para ser salvo.
WINBIO_E_INVALID_OPERATION
Nenhum registro está em andamento.
WINBIO_I_MORE_DATA
Mais exemplos são necessários para concluir o modelo.
WINBIO_E_BAD_CAPTURE
O exemplo mais recente não é utilizável.

RejectDetail

O motivo pelo qual o exemplo mais recente é inutilizável, se o valor do membro TemplateStatus for WINBIO_E_BAD_CAPTURE.

PercentComplete

A melhor estimativa do adaptador do mecanismo para o percentual do modelo concluído, como um valor de 0 a 100.

Fator

O tipo de unidade biométrica para a qual essa estrutura contém informações sobre recursos e requisitos de registro do adaptador do mecanismo. Por exemplo, se o valor do membro Factor for WINBIO_TYPE_FINGERPRINT, a estrutura WINBIO_EXTENDED_ENGINE_INFO se aplicará a um leitor de impressão digital e conterá as informações relevantes na estrutura Specifc.Fingerprint .

SubFator

Um valor WINBIO_BIOMETRIC_SUBTYPE que fornece informações adicionais sobre o registro.

Específico

Informações sobre o status de um registro em andamento para um fator biométrico específico.

Nulo

Reservado. Deve ser zero.

FacialFeatures

Informações sobre o status de um registro em andamento para recursos faciais.

Boundingbox

A posição dentro do quadro da câmera da face do indivíduo a ser registrado, em pixels. O tamanho do quadro da câmera determina o limite superior no número de pixels para essa posição. Obtenha a propriedade WINBIO_PROPERTY_EXTENDED_SENSOR_INFO para determinar o tamanho do quadro da câmera. Um cliente que usa o monitor de presença deve executar a operação de dimensionamento para mapear a posição para o quadro da câmera.

Distância

A distância entre o local real da face e a distância focal ideal para o rosto. Esse valor varia de -100 a 100. 0 indica a distância ideal, os valores positivos indicam que o local real da face está muito longe e os valores negativos indicam que o local real está muito próximo.

Fingerprint

Informações sobre o status de um registro em andamento para padrões de impressão digital.

GeneralSamples

O número total de exemplos necessários para criar um novo modelo de impressão digital.

Centro

O número de exemplos para o centro da impressão digital necessário para criar um novo modelo de impressão digital.

TopEdge

O número de exemplos para a borda superior da impressão digital necessária para criar um novo modelo de impressão digital.

BottomEdge

O número de exemplos para a borda inferior da impressão digital necessária para criar um novo modelo de impressão digital.

LeftEdge

O número de exemplos para a borda esquerda da impressão digital necessária para criar um novo modelo de impressão digital.

RightEdge

O número de exemplos para a borda direita da impressão digital necessária para criar um novo modelo de impressão digital.

Iris

Informações sobre o status de um registro em andamento para padrões de íris.

EyeBoundingBox_1

A posição dentro do quadro da câmera de uma das íris do indivíduo a ser registrado, em pixels. Se o sistema de reconhecimento de íris estiver monitorando apenas um olho, essa posição será da íris desse olho. Se o sistema de reconhecimento de íris estiver monitorando os dois olhos, mas apenas um olho estiver no quadro da câmera, essa posição será da íris do olho no quadro da câmera. Se o sistema de reconhecimento de íris estiver monitorando os dois olhos e ambos os olhos estiverem no quadro da câmera, essa posição provavelmente será da íris do olho direito do indivíduo.

O tamanho do quadro da câmera determina o limite superior no número de pixels para essa posição. Obtenha a propriedade WINBIO_PROPERTY_EXTENDED_SENSOR_INFO para determinar o tamanho do quadro da câmera. Um cliente que usa o monitor de presença deve executar a operação de dimensionamento para mapear a posição para o quadro da câmera.

EyeBoundingBox_2

A posição dentro do quadro da câmera de uma das íris do indivíduo a ser registrado, em pixels. Se o sistema de reconhecimento de íris estiver monitorando apenas um olho ou se apenas um olho estiver no quadro da câmera, esse valor estará vazio. Se o sistema de reconhecimento de íris estiver monitorando os dois olhos e ambos os olhos estiverem no quadro da câmera, essa posição provavelmente será de íris do olho esquerdo do indivíduo.

O tamanho do quadro da câmera determina o limite superior no número de pixels para essa posição. Obtenha a propriedade WINBIO_PROPERTY_EXTENDED_SENSOR_INFO para determinar o tamanho do quadro da câmera. Um cliente que usa o monitor de presença deve executar a operação de dimensionamento para mapear a posição para o quadro da câmera.

PupilCenter_1

A posição do centro de um dos alunos do indivíduo a ser registrado. Se o sistema de reconhecimento de íris estiver monitorando apenas um olho, essa posição será do centro da pupila desse olho. Se o sistema de reconhecimento de íris estiver monitorando os dois olhos, mas apenas um olho estiver no quadro da câmera, essa posição será do centro da pupila do olho no quadro da câmera. Se o sistema de reconhecimento de íris estiver monitorando os dois olhos e ambos os olhos estiverem no quadro da câmera, essa posição provavelmente será do centro da pupila do olho direito do indivíduo.

PupilCenter_2

A posição do centro de um dos alunos do indivíduo a ser registrado. Se o sistema de reconhecimento de íris estiver monitorando apenas um olho ou se apenas um olho estiver no quadro da câmera, esse valor estará vazio. Se o sistema de reconhecimento de íris estiver monitorando os dois olhos e ambos os olhos estiverem no quadro da câmera, essa posição provavelmente será do centro da pupila do olho esquerdo do indivíduo.

Distância

A distância entre o local real da íris e a distância focal ideal para a íris. Esse valor varia de -100 a 100. 0 indica a distância ideal, os valores positivos indicam que o local real da íris está muito longe e os valores negativos indicam que o local real está muito próximo.

Voz

Informações sobre o status de um registro em andamento para padrões de voz.

Reserved

Reservado.

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]
Cabeçalho
Winbio_types.h (inclua Winbio.h para aplicativos cliente ou Winbio_adapters.h para adaptadores)