PIBIO_ENGINE_QUERY_SAMPLE_HINT_FN funzione di callback (winbio_adapter.h)

Articolo
03/03/2024

Chiamato da Windows Biometric Framework per recuperare il numero di campioni corretti richiesti dall'adattatore del motore per costruire un modello di registrazione.

Sintassi

PIBIO_ENGINE_QUERY_SAMPLE_HINT_FN PibioEngineQuerySampleHintFn;

HRESULT PibioEngineQuerySampleHintFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PSIZE_T SampleHint
)
{...}

Parametri

[in, out] Pipeline

Puntatore a una struttura WINBIO_PIPELINE associata all'unità biometrica che esegue l'operazione.

[out] SampleHint

Puntatore a una variabile che riceve il numero di campioni necessari.

Valore restituito

Se la funzione ha esito positivo, restituisce S_OK. Se la funzione ha esito negativo, deve restituire uno dei valori HRESULT seguenti per indicare l'errore.

Codice restituito	Descrizione
E_POINTER	Un parametro del puntatore obbligatorio è NULL.
WINBIO_E_UNSUPPORTED_PROPERTY	L'adattatore del motore non supporta questa proprietà.

Commenti

Se un adattatore del motore richiede un numero diverso di campioni in situazioni diverse, è necessario restituire il numero più grande. Ad esempio, se un motore di impronta digitale richiede più scorrimenti per un dito di indice rispetto a un pollice, restituire il numero necessario per il dito dell'indice.

Il valore restituito dal parametro SampleHint specifica il numero di campioni corretti necessari. A causa di acquisizioni non valido, il numero effettivo di campioni necessari durante la registrazione può essere maggiore del numero specificato.

Esempio

Lo pseudocode seguente mostra una possibile implementazione di questa funzione. L'esempio non viene compilato. Devi adattarla per adattarti al tuo scopo.

//////////////////////////////////////////////////////////////////////////////////////////
//
// EngineAdapterQuerySampleHint
//
// Purpose: 
//      Retrieves the number of correct samples required by the engine adapter 
//      to construct an enrollment template.
//
// Parameters:
//      Pipeline    - Pointer to a WINBIO_PIPELINE structure associated 
//                    with the biometric unit performing the operation. 
//      SampleHint  - Pointer to a variable that receives the number of 
//                    required samples.
//
static HRESULT
WINAPI
EngineAdapterQuerySampleHint(
    __inout PWINBIO_PIPELINE Pipeline,
    __out PSIZE_T SampleHint
    )
{
    // Verify that pointer arguments are not NULL.
    if (!ARGUMENT_PRESENT(Pipeline) ||
        !ARGUMENT_PRESENT(SampleHint))
    {
        hr = E_POINTER;
        goto cleanup;
    }

    // The sample hint specified here is a constant but can also be a 
    // function of the hardware model or the device settings depending
    // on your adapter.
    // If your adapter does not support this feature, return
    // WINBIO_E_UNSUPPORTED_PROPERTY.
    *SampleHint = SAMPLES_REQUIRED_FOR_ENROLLMENT;

cleanup:

    return hr;
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbio_adapter.h (includere Winbio_adapter.h)

Vedi anche

EngineAdapterAcceptSampleData

Funzioni plug-in

Condividi tramite