Share via


PIBIO_ENGINE_ACTIVATE_FN Rückruffunktion (winbio_adapter.h)

Wird vom Biometrischen Windows-Framework aufgerufen, um dem Engine-Adapter die Möglichkeit zu geben, alle Aufgaben auszuführen, die erforderlich sind, um die Sensorkomponente aus einem Leerlaufzustand zu bringen.

Syntax

PIBIO_ENGINE_ACTIVATE_FN PibioEngineActivateFn;

HRESULT PibioEngineActivateFn(
  [in, out] PWINBIO_PIPELINE Pipeline
)
{...}

Parameter

[in, out] Pipeline

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

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
Der Pipelineparameter darf nicht NULL sein.

Hinweise

Diese Methode wird aufgerufen, wenn die erste Clientsitzung ein Handle für eine inaktive biometrische Einheit öffnet.

Der Speicheradapter wurde aktiviert, wenn diese Methode aufgerufen wird.

Die Rückgabe eines anderen HRESULT als S_OK führt dazu, dass das Windows Biometric Framework den Fehler protokolliert und die Aktivierung der biometrischen Einheit abbricht.

Diese Methode wird im Kontext des Sensorsteuerungsthreads ausgeführt, der alle anderen Anforderungen für die Einheit verarbeitet, einschließlich der Deaktivierung.

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)