PIBIO_SENSOR_QUERY_CALIBRATION_FORMATS_FN fonction de rappel (winbio_adapter.h)

Article
03/03/2024

Appelé par l’infrastructure biométrique Windows pour déterminer l’ensemble des formats d’étalonnage pris en charge par l’adaptateur de capteur.

Syntaxe

PIBIO_SENSOR_QUERY_CALIBRATION_FORMATS_FN PibioSensorQueryCalibrationFormatsFn;

HRESULT PibioSensorQueryCalibrationFormatsFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PWINBIO_UUID FormatArray,
  [in]      SIZE_T FormatArraySize,
  [out]     PSIZE_T FormatCount
)
{...}

Paramètres

[in, out] Pipeline

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

[out] FormatArray

Adresse d’un tableau d’éléments WINBIO_UUID vides. La méthode SensorAdapterQueryCalibrationFormats est censée remplir ce tableau avec un ou plusieurs UUID identifiant les formats de données d’étalonnage connus de l’adaptateur de capteur.

[in] FormatArraySize

Valeur indiquant le nombre d’emplacements disponibles dans FormatArray. La méthode SensorAdapterQueryCalibrationFormats ne doit pas tenter d’écrire plus que ce nombre d’éléments dans FormatArray, sinon les résultats seront imprévisibles.

[out] FormatCount

Pointeur vers une variable qui reçoit le nombre d’UUID retournés dans FormatArray. La méthode SensorAdapterQueryCalibrationFormats doit définir cette valeur avant de retourner.

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_NOTIMPL	: l’adaptateur capteur ne prend pas en charge l’étalonnage dynamique.
E_some_other_error	Tout autre code d’erreur entraîne la journalisation de l’erreur par l’infrastructure biométrique Windows et l’abandon de la configuration de l’unité biométrique.

Remarques

Cette méthode est appelée une seule fois lors de la configuration initiale d’une unité biométrique.

Chaque format d’étalonnage pris en charge par l’adaptateur de capteur est identifié par une valeur UUID distincte.

Cette méthode s’exécute dans le contexte d’un thread de serveur RPC arbitraire.

Si l’adaptateur capteur ne prend pas en charge l’étalonnage dynamique, il doit retourner une valeur de E_NOTIMPL. L’infrastructure biométrique Windows ne traitera pas cela comme une erreur, sauf si l’adaptateur moteur nécessite un étalonnage dynamique. (Pour plus d’informations, consultez la description de la méthode EngineAdapterSelectCalibrationFormat .)

Si cette méthode retourne une valeur de S_OK, FormatArray et FormatCount doivent être définis. Cette méthode renvoie S_OK ainsi qu’une valeur zéro pour FormatCount. Cela entraîne la journalisation d’un message d’erreur WINBIO_E_INVALID_CALIBRATION_FORMAT_ARRAY et l’abandon de la configuration de l’unité biométrique.

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