PIBIO_ENGINE_QUERY_PREFERRED_FORMAT_FN Rückruffunktion (winbio_adapter.h)
Wird vom Sensoradapter auf der biometrischen Einheit aufgerufen, um das vom Moduladapter bevorzugte Eingabedatenformat zu bestimmen.
Syntax
PIBIO_ENGINE_QUERY_PREFERRED_FORMAT_FN PibioEngineQueryPreferredFormatFn;
HRESULT PibioEngineQueryPreferredFormatFn(
[in, out] PWINBIO_PIPELINE Pipeline,
[out] PWINBIO_REGISTERED_FORMAT StandardFormat,
[out] PWINBIO_UUID VendorFormat
)
{...}
Parameter
[in, out] Pipeline
Zeiger auf eine WINBIO_PIPELINE Struktur, die der biometrischen Einheit zugeordnet ist, die den Vorgang ausführt.
[out] StandardFormat
Zeiger auf eine WINBIO_REGISTERED_FORMAT-Struktur , die das Format der Daten im StandardDataBlock-Element des WINBIO_BIR-Objekts angibt. Das Format ist ein IBIA-registriertes Name/Wert-Paar.
[out] VendorFormat
Zeiger auf eine GUID, die das vom Hersteller definierte Format der Daten im VendorDataBlock-Member des WINBIO_BIR-Objekts 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 |
|---|---|
|
Ein obligatorischer Zeigerparameter ist NULL. |
Hinweise
Der Sensoradapter ruft diese Funktion auf, um das biometrische Erfassungsformat zu bestimmen.
Beispiele
Der folgende Pseudocode zeigt eine mögliche Implementierung dieser Funktion. Das Beispiel wird nicht kompiliert. Sie müssen es an Ihren Zweck anpassen.
//////////////////////////////////////////////////////////////////////////////////////////
//
// EngineAdapterQueryPreferredFormat
//
// Purpose:
// Called by the sensor adapter on the biometric unit to determine the
// input data format preferred by the engine adapter.
//
// Parameters:
// Pipeline - Pointer to a WINBIO_PIPELINE structure associated
// with the biometric unit performing the operation.
// StandardFormat - Pointer to a WINBIO_REGISTERED_FORMAT structure
// that specifies the format of the data in the
// StandardDataBlock member of the WINBIO_BIR object.
// The format is an IBIA-registered name/value pair.
// VendorFormat - Pointer to a GUID that receives the vendor-defined
// format of the data in the VendorDataBlock member of
// the WINBIO_BIR object.
//
static HRESULT
WINAPI
EngineAdapterQueryPreferredFormat(
__inout PWINBIO_PIPELINE Pipeline,
__out PWINBIO_REGISTERED_FORMAT StandardFormat,
__out PWINBIO_UUID VendorFormat
)
{
HRESULT hr = S_OK;
// Verify that pointer arguments are not NULL.
if (!ARGUMENT_PRESENT(Pipeline) ||
!ARGUMENT_PRESENT(StandardFormat) ||
!ARGUMENT_PRESENT(VendorFormat))
{
hr = E_POINTER;
goto cleanup;
}
// Specify the preferred data formats.
StandardFormat->Owner = WINBIO_ANSI_381_FORMAT_OWNER;
StandardFormat->Type = WINBIO_ANSI_381_FORMAT_TYPE;
*VendorFormat = VENDOR_UUID_VALUE;
cleanup:
return hr;
}
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) |