PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN Rückruffunktion (winbio_adapter.h)

Artikel
03/06/2024

Wird vom Windows Biometric Framework aufgerufen, um eine Reihe von Kalibrierungsdaten nach der Erfassung vom Moduladapter abzurufen.

Syntax

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

Parameter

[in, out] Pipeline

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

[out] DiscardAndRepeatCapture

Adresse eines booleschen Werts, der von der EngineAdapterQueryCalibrationData-Methode festgelegt werden muss. Dieser Wert gibt an, was der biometrische Dienst mit der aktuellen Stichprobe tun soll, nachdem die Kalibrierung abgeschlossen ist.

TRUE gibt an, dass die erfasste biometrische Probe nicht verwendbar ist. Der biometrische Dienst verwirft die Probe und sammelt eine neue.
FALSE gibt an, dass das Beispiel verwendbar ist und die Engine angewiesen werden sollte, weitere Vorgänge daran auszuführen.

[out] CalibrationBuffer

Adresse eines leeren Puffers, in dem die Methode ihre Kalibrierungsdaten schreiben soll. Der Speicher, der diesen Puffer enthält, gehört zum biometrischen Dienst, und der Moduladapter darf keine Zeiger auf diesen Puffer beibehalten, sobald die EngineAdapterQueryCalibrationData-Methode zurückgegeben wird .

[out] CalibrationBufferSize

Adresse einer Variablen, in der die EngineAdapterQueryCalibrationData-Methode die Größe (in Bytes) der Kalibrierungsdaten speichert, die sie in CalibrationBuffer geschrieben hat. Dieser Wert darf MaxBufferSize nicht überschreiten.

Wenn EngineAdapterQueryCalibrationData diesen Wert auf Null festlegt, wird der Inhalt des CalibrationBuffer verworfen, ohne sie an den Sensoradapter zu senden. Dies ist keine Fehlerbedingung. Es gibt einfach an, dass der Engine-Adapter die Kalibrierung des Sensors nicht basierend auf den aktuellen Erfassungsdaten aktualisieren muss.

[in] MaxBufferSize

Ein Wert, der den maximalen Speicherplatz (in Bytes) angibt, der dem Engine-Adapter im CalibrationBuffer zur Verfügung steht.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Wenn die Funktion fehlschlägt, muss sie einen der folgenden HRESULT-Werte zurückgeben, um den Fehler anzugeben.

Rückgabecode	Beschreibung
E_some_error	Jeder Fehlercode führt dazu, dass der biometrische Dienst die dynamische Kalibrierungsschleife beendet und den Erfassungsvorgang abbricht.

Hinweise

Die EngineAdapterQueryCalibrationData-Methode kann das Wiederholungserfassungsverhalten des biometrischen Diensts und das Kalibrierungsverhalten unabhängig steuern, indem Sie DiscardAndRepeatCapture bzw . CalibrationBufferSize festlegen.

Gewünschtes Verhalten	DiscardAndRepeatCapture	CalibrationBufferSize
Wiederholen Sie die Erfassung nach der Kalibrierung.	TRUE	Nicht Null
Wiederholen Sie die Erfassung ohne Kalibrierung.	TRUE	Null
Fahren Sie nach der Kalibrierung mit der Verarbeitung des Beispiels fort.	FALSE	Nicht Null
Fahren Sie mit der Verarbeitung der Probe ohne Kalibrierung fort.	FALSE	Null

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 (einschließlich Winbio_adapter.h)

Share via