PIBIO_ENGINE_IDENTIFY_ALL_FN fonction de rappel (winbio_adapter.h)

Article
08/27/2023

Appelé par l’infrastructure biométrique Windows pour déterminer les identités de toutes les personnes qui se trouvent actuellement dans le cadre de la caméra.

Syntaxe

PIBIO_ENGINE_IDENTIFY_ALL_FN PibioEngineIdentifyAllFn;

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

Paramètres

[in, out] Pipeline

Pointeur vers la structure WINBIO_PIPELINE associée à l’unité biométrique effectuant l’opération.

[out] PresenceCount

Adresse d’une variable qui reçoit le nombre de présences détectées par la fonction .

[out] PresenceArray

Adresse d’une variable qui reçoit un pointeur vers un tableau d’éléments WINBIO_PRESENCE .

Valeur retournée

Si la fonction réussit, elle retourne S_OK. Si la fonction échoue, elle doit retourner l’une des valeurs HRESULT suivantes pour indiquer l’erreur.

Code de retour	Description
E_some_error	Tout code d’erreur oblige le service biométrique à enregistrer l’erreur et à ignorer le cadre de l’appareil photo.

Remarques

Le service biométrique appelle cette méthode après avoir envoyé une nouvelle trame de données à l’adaptateur du moteur.

Après avoir traité la trame de données, cette fonction doit retourner un élément WINBIO_PRESENCE pour chaque présence détectée dans la trame de données.

Dans le cas où la fonction EngineAdapterIdentifyAll ne peut pas trouver de visages dans le cadre, elle retourne un HRESULT de S_OK et définit les paramètres de retour PresenceCount et PresenceArray sur zéro et NULL, respectivement. En d’autres termes, un cadre qui ne contient aucune présence humaine n’est pas une condition d’erreur.

Le seul moment où EngineAdapterIdentifyAll doit retourner un HRESULT autre que S_OK est s’il ne souhaite pas que le service bio utilise l’image pour mettre à jour l’état du moniteur de présence. Il devrait s’agir d’un événement rare. L’adaptateur moteur est chargé d’allouer le tableau d’éléments WINBIO_PRESENCE qu’il retourne dans le paramètre PresenceArray . Il doit allouer cette mémoire à partir du tas de processus à l’aide de la fonction HeapAlloc . Une fois le tableau créé, il devient la propriété de l’infrastructure biométrique Windows. Étant donné que l’infrastructure libère cette mémoire après l’avoir utilisée, votre adaptateur moteur ne doit pas tenter de libérer le tableau ou d’enregistrer un pointeur vers celui-ci. Le non-respect de cette règle entraîne une altération du tas et des incidents possibles du service biométrique.

Les valeurs des éléments WINBIO_PRESENCE individuels dans PresenceArray déterminent les événements générés pour les applications clientes. Pour plus d’informations, consultez la discussion sur la structure WINBIO_PRESENCE .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	winbio_adapter.h (include Winbio_adapter.h)

Partager via