PIBIO_SENSOR_QUERY_EXTENDED_INFO_FN Rückruffunktion (winbio_adapter.h)

2023-08-27

Wird vom Windows Biometric Framework aufgerufen, um die Funktionen und Einschränkungen der komponente biometrischer Sensoren zu bestimmen.

Syntax

PIBIO_SENSOR_QUERY_EXTENDED_INFO_FN PibioSensorQueryExtendedInfoFn;

HRESULT PibioSensorQueryExtendedInfoFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PWINBIO_EXTENDED_SENSOR_INFO SensorInfo,
  [in]      SIZE_T SensorInfoSize
)
{...}

Parameter

[in, out] Pipeline

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

[out] SensorInfo

Zeiger auf die WINBIO_EXTENDED_SENSOR_INFO Struktur, die die von dieser Funktion zurückgegebenen Sensorinformationen enthält.

[in] SensorInfoSize

Die angegebene Größe der Sensorinformationen.

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_POINTER	Die Parameter Pipeline und SensorInfo dürfen nicht NULL sein.
E_INVALIDARG	Der SensorInfoSize-Wert ist kleiner als die Größe, die zum Zurückgeben der Sensorinformationen erforderlich ist.

Hinweise

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

Sie wird auch aufgerufen, wenn eine Clientanwendung die WinBioGetProperty-Funktion verwendet, um den Wert der WINBIO_PROPERTY_EXTENDED_SENSOR_INFO-Eigenschaft abzufragen.

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)