PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN fonction de rappel (winbio_adapter.h)

Article
03/06/2024

Appelé par l’infrastructure biométrique Windows pour obtenir un ensemble de données d’étalonnage post-capture à partir de l’adaptateur moteur.

Syntaxe

PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN PibioEngineQueryCalibrationDataFn;

HRESULT PibioEngineQueryCalibrationDataFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PBOOLEAN DiscardAndRepeatCapture,
  [out]     PUCHAR CalibrationBuffer,
  [out]     PSIZE_T CalibrationBufferSize,
  [in]      SIZE_T MaxBufferSize
)
{...}

Paramètres

[in, out] Pipeline

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

[out] DiscardAndRepeatCapture

Adresse d’une valeur booléenne qui doit être définie par la méthode EngineAdapterQueryCalibrationData . Cette valeur indique ce que le service biométrique doit faire avec l’échantillon actuel une fois l’étalonnage terminé.

TRUE indique que l’exemple biométrique capturé est inutilisable. Le service biométrique ignore l’échantillon et en collecte un nouveau.
FALSE indique que l’exemple est utilisable et que le moteur doit être invité à effectuer d’autres opérations sur celui-ci.

[out] CalibrationBuffer

Adresse d’une mémoire tampon vide où la méthode est censée écrire ses données d’étalonnage. La mémoire contenant cette mémoire tampon appartient au service biométrique, et l’adaptateur moteur ne doit pas conserver de pointeurs vers cette mémoire tampon une fois que la méthode EngineAdapterQueryCalibrationData est retournée.

[out] CalibrationBufferSize

Adresse d’une variable où la méthode EngineAdapterQueryCalibrationData stocke la taille (en octets) des données d’étalonnage qu’elle a écrites dans CalibrationBuffer. Cette valeur ne doit pas dépasser MaxBufferSize.

Si EngineAdapterQueryCalibrationData définit cette valeur sur zéro, le contenu de CalibrationBuffer est ignoré sans l’envoyer à l’adaptateur de capteur. Il ne s’agit pas d’une condition d’erreur ; cela indique simplement que l’adaptateur moteur n’a pas besoin de mettre à jour l’étalonnage du capteur en fonction des données de capture actuelles.

[in] MaxBufferSize

Valeur indiquant l’espace maximal (en octets) disponible pour l’adaptateur de moteur dans CalibrationBuffer.

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 entraîne l’arrêt de la boucle d’étalonnage dynamique par le service biométrique et l’abandon de l’opération de capture.

Remarques

La méthode EngineAdapterQueryCalibrationData peut contrôler indépendamment le comportement de capture répétée du service biométrique et le comportement d’étalonnage en définissant, respectivement , DiscardAndRepeatCapture et CalibrationBufferSize.

Comportement souhaité	DiscardAndRepeatCapture	CalibrationBufferSize
Répétez la capture après l’étalonnage.	TRUE	Valeur autre que zéro
Répétez la capture sans étalonnage.	TRUE	Zéro
Poursuivez le traitement de l’exemple après l’étalonnage.	FALSE	Valeur autre que zéro
Poursuivez le traitement de l’exemple sans étalonnage.	FALSE	Zéro

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