Compartir a través de

PIBIO_ENGINE_QUERY_SAMPLE_HINT_FN función de devolución de llamada (winbio_adapter.h)

  • Artículo

Llamado por Windows Biometric Framework para recuperar el número de muestras correctas requeridas por el adaptador del motor para construir una plantilla de inscripción.

Sintaxis

PIBIO_ENGINE_QUERY_SAMPLE_HINT_FN PibioEngineQuerySampleHintFn;

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

Parámetros

[in, out] Pipeline

Puntero a una estructura de WINBIO_PIPELINE asociada a la unidad biométrica que realiza la operación.

[out] SampleHint

Puntero a una variable que recibe el número de muestras necesarias.

Valor devuelto

Si la función se ejecuta correctamente, devuelve S_OK. Si se produce un error en la función, debe devolver uno de los siguientes valores HRESULT para indicar el error.

Código devuelto Descripción
E_POINTER
 Un parámetro de puntero obligatorio es NULL.
WINBIO_E_UNSUPPORTED_PROPERTY
 El adaptador del motor no admite esta propiedad.

Comentarios

Si un adaptador de motor requiere un número diferente de muestras en diferentes situaciones, debe devolver el mayor número. Por ejemplo, si un motor de huellas digitales requiere más deslizamientos para un dedo índice que para un pulgar, devuelva el número necesario para el dedo de índice.

El valor devuelto por el parámetro SampleHint especifica el número de muestras correctas necesarias. Debido a las capturas incorrectas, el número real de muestras necesarias durante la inscripción puede ser mayor que el número especificado.

Ejemplos

El siguiente pseudocódigo muestra una posible implementación de esta función. El ejemplo no se compila. Debes adaptarlo para que se adapte a tu propósito.

//////////////////////////////////////////////////////////////////////////////////////////
//
// 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;
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbio_adapter.h (incluya Winbio_adapter.h)

Consulte también

EngineAdapterAcceptSampleData

Funciones de complemento