PIBIO_ENGINE_QUERY_INDEX_VECTOR_SIZE_FN Rückruffunktion (winbio_adapter.h)
Wird vom Windows Biometric Framework aufgerufen, um die Größe des vom Engineadapter verwendeten Indexvektors abzurufen.
Syntax
PIBIO_ENGINE_QUERY_INDEX_VECTOR_SIZE_FN PibioEngineQueryIndexVectorSizeFn;
HRESULT PibioEngineQueryIndexVectorSizeFn(
[in, out] PWINBIO_PIPELINE Pipeline,
[out] PSIZE_T IndexElementCount
)
{...}
Parameter
[in, out] Pipeline
Zeiger auf eine WINBIO_PIPELINE Struktur, die der biometrischen Einheit zugeordnet ist, die den Vorgang ausführt.
[out] IndexElementCount
Adresse einer Variablen, die die Anzahl der Arrayelemente im Indexvektor 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 Indexvektor wird vom Engineadapter verwendet, um die verfügbaren biometrischen Vorlagen zu indizieren.
Beispiele
Der folgende Pseudocode zeigt eine mögliche Implementierung dieser Funktion. Das Beispiel wird nicht kompiliert. Sie müssen es an Ihren Zweck anpassen.
///////////////////////////////////////////////////////////////////////////////
//
// EngineAdapterQueryIndexVectorSize
//
// Purpose:
// Called by the Windows Biometric Framework to retrieve the size of
// the index vector used by the engine adapter.
//
// Parameters:
// Pipeline - Pointer to a WINBIO_PIPELINE structure associated
// with the biometric unit performing the operation.
// IndexElementCount - Address of a variable that receives the number of
// elements in the index vector.
//
static HRESULT
WINAPI
EngineAdapterQueryIndexVectorSize(
__inout PWINBIO_PIPELINE Pipeline,
__out PSIZE_T IndexElementCount
)
{
HRESULT hr = S_OK;
// Verify that pointer arguments are not NULL.
if (!ARGUMENT_PRESENT(Pipeline) ||
!ARGUMENT_PRESENT(IndexElementCount))
{
hr = E_POINTER;
goto cleanup;
}
// Specify the number of index vector elements supported by your adapter. This can
// be any positive value or zero. Return zero if your adapter does not support placing
// templates into buckets. That is, return zero if your adapter does not support index
// vectors.
*IndexElementCount = NUMBER_OF_TEMPLATE_BINS;
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) |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für