Compartir a través de

PIBIO_ENGINE_IDENTIFY_ALL_FN función de devolución de llamada (winbio_adapter.h)

  • Artículo

Llamado por windows Biometric Framework para determinar las identidades de cualquier persona que se encuentra actualmente en el marco de la cámara.

Sintaxis

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

Puntero a la estructura WINBIO_PIPELINE asociada a la unidad biométrica que realiza la operación.

[out] PresenceCount

Dirección de una variable que recibe el número de presencias detectadas por la función.

[out] PresenceArray

Dirección de una variable que recibe un puntero a una matriz de elementos WINBIO_PRESENCE .

Valor devuelto

Si la función se realiza correctamente, devuelve S_OK. Si se produce un error en la función, debe devolver uno de los siguientes valores HRESULT para indicar el error.

Código devuelto Descripción
E_some_error
Cualquier código de error hará que el servicio biométrico registre el error y omita el marco de la cámara.

Comentarios

El servicio biométrico llama a este método después de enviar una nueva trama de datos al adaptador del motor.

Después de procesar la trama de datos, esta función debe devolver un elemento WINBIO_PRESENCE para cada presencia detectada en la trama de datos.

En caso de que la función EngineAdapterIdentifyAll no encuentre ninguna cara en el marco, devuelve un HRESULT de S_OK y establece los parámetros de devolución PresenceCount y PresenceArray en cero y NULL, respectivamente. Es decir, un marco que no contiene ninguna presencia humana no es una condición de error.

La única vez que EngineAdapterIdentifyAll debe devolver un VALOR HRESULT distinto de S_OK es si no desea que el servicio bio use el marco para actualizar el estado del Monitor de presencia. Esto debería ser una rara aparición. El adaptador del motor es responsable de asignar la matriz de WINBIO_PRESENCE elementos que devuelve en el parámetro PresenceArray . Debe asignar esta memoria desde el montón de procesos mediante la función HeapAlloc . Una vez creada la matriz, se convierte en la propiedad del marco biométrico de Windows. Dado que Framework desasigna esta memoria después de usarla, el adaptador del motor no debe intentar desasignar la matriz ni guardarle un puntero. Si no se sigue esta regla, se producirán daños en el montón y posibles bloqueos del servicio biométrico.

Los valores de los elementos de WINBIO_PRESENCE individuales de PresenceArray determinarán los eventos generados para las aplicaciones cliente. Consulte la explicación de la estructura de WINBIO_PRESENCE para obtener más información.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbio_adapter.h (incluya Winbio_adapter.h)