PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN fonction de rappel (winbio_adapter.h)

Article
08/27/2023

Appelé par l’infrastructure biométrique Windows pour déterminer les formats d’étalonnage de l’adaptateur de capteur que l’adaptateur moteur souhaite utiliser.

Syntaxe

PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN PibioEngineSelectCalibrationFormatFn;

HRESULT PibioEngineSelectCalibrationFormatFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PWINBIO_UUID FormatArray,
  [in]      SIZE_T FormatCount,
  [out]     PWINBIO_UUID SelectedFormat,
  [out]     PSIZE_T MaxBufferSize
)
{...}

Paramètres

[in, out] Pipeline

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

[in] FormatArray

Adresse d’un tableau d’éléments WINBIO_UUID identifiant les formats de données d’étalonnage pris en charge par l’adaptateur de capteur. L’adaptateur moteur doit choisir l’un de ces formats pour ses données d’étalonnage.

[in] FormatCount

Valeur indiquant le nombre d’UUID dans le paramètre FormatArray .

[out] SelectedFormat

Adresse d’un élément WINBIO_UUID où la méthode EngineAdapterSelectCalibrationFormat stocke l’UUID du format d’étalonnage sélectionné. Il doit s’agir de l’un des UUID dans le paramètre FormatArray .

[out] MaxBufferSize

Adresse d’une variable dans laquelle la méthode EngineAdapterSelectCalibrationFormat stocke la taille maximale (en octets) des données d’étalonnage qu’elle prévoit de retourner à l’adaptateur de capteur. La taille maximale de cette mémoire tampon doit être de 4 096 octets ou moins.

Valeur retournée

La fonction retourne l’une des valeurs HRESULT suivantes.

Code de retour	Description
S_OK	L’opération a réussi. Les valeurs de retour SelectedFormat et MaxBufferSize ont toutes deux été définies.
E_NOTIMPL	L’adaptateur moteur ne nécessite pas d’étalonnage dynamique. Ce n’est pas un état d’erreur. Le service biométrique convertit cette valeur en S_OK, et l’unité biométrique est configurée pour ne pas utiliser l’étalonnage dynamique.
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT	L’adaptateur moteur nécessite un étalonnage dynamique, mais ne prend en charge aucun des formats d’étalonnage spécifiés dans le paramètre FormatArray . (L’adaptateur moteur doit également retourner ce code d’erreur si l’argument FormatCount est égal à zéro.) Ce code d’erreur entraîne le service biométrique à consigner l’erreur et à abandonner la configuration de l’unité biométrique.
E_some_other_error	Tout autre code d’erreur oblige le service biométrique à consigner l’erreur et à abandonner la configuration de l’unité biométrique.

Remarques

Cette méthode est appelée une seule fois lors de la configuration de l’unité biométrique. Une fois qu’un format d’étalonnage a été sélectionné, il ne peut pas être modifié.

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