PIBIO_SENSOR_QUERY_CALIBRATION_FORMATS_FN Rückruffunktion (winbio_adapter.h)

Artikel
03/06/2024

Wird vom Windows Biometric Framework aufgerufen, um den Satz von Kalibrierungsformaten zu bestimmen, die vom Sensoradapter unterstützt werden.

Syntax

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

Parameter

[in, out] Pipeline

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

[out] FormatArray

Adresse eines Arrays mit leeren WINBIO_UUID Elementen. Es wird erwartet, dass die SensorAdapterQueryCalibrationFormats-Methode dieses Array mit einer oder mehreren UUIDs füllt, die die Kalibrierungsdatenformate identifizieren, die dem Sensoradapter bekannt sind.

[in] FormatArraySize

Ein Wert, der die Anzahl der in FormatArray verfügbaren Slots angibt. Die SensorAdapterQueryCalibrationFormats-Methode darf nicht versuchen, mehr als diese Anzahl von Elementen in FormatArray zu schreiben, da sonst die Ergebnisse unvorhersehbar sind.

[out] FormatCount

Zeiger auf eine Variable, die die in FormatArray zurückgegebenen UUIDs empfängt. Die SensorAdapterQueryCalibrationFormats-Methode muss diesen Wert vor der Rückgabe festlegen.

Rückgabewert

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

Rückgabecode	Beschreibung
E_NOTIMPL	– Der Sensoradapter unterstützt keine dynamische Kalibrierung.
E_some_other_error	Jeder andere Fehlercode bewirkt, dass das Windows Biometric Framework den Fehler protokolliert und die Konfiguration der biometrischen Einheit abbricht.

Hinweise

Diese Methode wird einmal während der Erstkonfiguration einer biometrischen Einheit aufgerufen.

Jedes vom Sensoradapter unterstützte Kalibrierungsformat wird durch einen separaten UUID-Wert identifiziert.

Diese Methode wird im Kontext eines beliebigen RPC-Serverthreads ausgeführt.

Wenn der Sensoradapter keine dynamische Kalibrierung unterstützt, sollte er den Wert E_NOTIMPL zurückgeben. Das Windows Biometric Framework behandelt dies nicht als Fehler, es sei denn, der Engine-Adapter erfordert eine dynamische Kalibrierung. (Ausführliche Informationen finden Sie in der Beschreibung der EngineAdapterSelectCalibrationFormat-Methode .)

Wenn diese Methode den Wert S_OK zurückgibt, müssen FormatArray und FormatCount festgelegt werden. Es ist ein Fehler für diese Methode, S_OK zusammen mit einem Nullwert für FormatCount zurückzugeben. Dies führt dazu, dass das Windows Biometric Framework eine WINBIO_E_INVALID_CALIBRATION_FORMAT_ARRAY Fehlermeldung protokolliert und die Konfiguration der biometrischen Einheit abbricht.

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)

Share via