PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN Rückruffunktion (winbio_adapter.h)

Artikel
03/13/2024

Wird vom Windows Biometric Framework aufgerufen, um zu bestimmen, welches der Kalibrierungsformate des Sensoradapters vom Engine Adapter verwendet werden soll.

Syntax

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
)
{...}

Parameter

[in, out] Pipeline

Zeiger auf die WINBIO_PIPELINE Struktur, die der biometrischen Einheit zugeordnet ist, die den Vorgang ausführt.

[in] FormatArray

Adresse eines Arrays von WINBIO_UUID Elementen, die die vom Sensoradapter unterstützten Kalibrierungsdatenformate identifizieren. Es wird erwartet, dass der Engine-Adapter eines dieser Formate für seine Kalibrierungsdaten auswäht.

[in] FormatCount

Wert, der die Anzahl der UUIDs im FormatArray-Parameter angibt.

[out] SelectedFormat

Adresse eines WINBIO_UUID Elements, in dem die EngineAdapterSelectCalibrationFormat-Methode die UUID des ausgewählten Kalibrierungsformats speichert. Dies muss eine der UUIDs im FormatArray-Parameter sein.

[out] MaxBufferSize

Adresse einer Variablen, in der die EngineAdapterSelectCalibrationFormat-Methode die maximale Größe (in Byte) aller Kalibrierungsdaten speichert, die an den Sensoradapter zurückgegeben werden sollen. Die maximale Größe dieses Puffers muss 4.096 Bytes oder weniger betragen.

Rückgabewert

Die Funktion gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	Beschreibung
S_OK	Der Vorgang wurde erfolgreich ausgeführt. Die Rückgabewerte SelectedFormat und MaxBufferSize wurden beide festgelegt.
E_NOTIMPL	Für den Engine-Adapter ist keine dynamische Kalibrierung erforderlich. Dies ist keine Fehlerbedingung. Der biometrische Dienst konvertiert diesen Wert in S_OK, und die biometrische Einheit wird so konfiguriert, dass keine dynamische Kalibrierung verwendet wird.
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT	Der Engine Adapter erfordert eine dynamische Kalibrierung, unterstützt aber keines der im FormatArray-Parameter angegebenen Kalibrierungsformate. (Der Engine-Adapter sollte diesen Fehlercode auch zurückgeben, wenn das FormatCount-Argument null ist.) Dieser Fehlercode führt dazu, dass der biometrische Dienst den Fehler protokolliert und die Konfiguration der biometrischen Einheit abbricht.
E_some_other_error	Jeder andere Fehlercode bewirkt, dass der biometrische Dienst den Fehler protokolliert und die Konfiguration der biometrischen Einheit abbricht.

Hinweise

Diese Methode wird einmal während der Konfiguration der biometrischen Einheit aufgerufen. Nachdem ein Kalibrierungsformat ausgewählt wurde, kann es nicht mehr geändert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbio_adapter.h (Winbio_adapter.h einschließen)

Freigeben über