WbioQuerySensorInterface-Funktion (winbio_adapter.h)

Artikel
08/27/2023

Ruft einen Zeiger auf die WINBIO_SENSOR_INTERFACE-Struktur für den Sensoradapter ab.

Syntax

HRESULT WbioQuerySensorInterface(
  [out] PWINBIO_SENSOR_INTERFACE *SensorInterface
);

Parameter

[out] SensorInterface

Adresse einer Variablen, die einen Zeiger auf die WINBIO_SENSOR_INTERFACE-Struktur empfängt.

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 SensorInterface-Parameter darf nicht NULL sein.

Hinweise

Das Windows Biometric Framework ruft diese Funktion auf, nachdem eine Sensoradapter-DLL in den Arbeitsspeicher geladen wurde. Jede Sensoradapter-DLL muss daher die WbioQueryEngineInterface-Funktion implementieren und exportieren. Beim Funktionsnamen wird die Groß-/Kleinschreibung beachtet, und die Schreibweise und Signatur müssen genau mit der Beschreibung im Abschnitt Syntax übereinstimmen.

Damit für das biometrische Windows-Framework sichtbar ist, muss die WbioQueryEngineInterface-Funktion im Abschnitt EXPORTS der Befehlsdatei des Exportdefinitionslinkers für die DLL benannt werden.

Beispiele

Der folgende Pseudocode zeigt eine mögliche Implementierung dieser Funktion.

HRESULT
WINAPI
WbioQuerySensorInterface(
    __out PWINBIO_SENSOR_INTERFACE *SensorInterface
    )
{
    // g_SensorInterface is a global variable.
    *SensorInterface = &g_SensorInterface;
    return S_OK;
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbio_adapter.h (einschließlich Winbio_adapter.h)

Weitere Informationen

Plug-In-Funktionen

Freigeben über