функция обратного вызова PIBIO_ENGINE_QUERY_SAMPLE_HINT_FN (winbio_adapter.h)

Статья
03/09/2024

Вызывается Платформой Биометрических данных Windows для получения количества правильных выборок, необходимых адаптеру подсистемы для создания шаблона регистрации.

Синтаксис

PIBIO_ENGINE_QUERY_SAMPLE_HINT_FN PibioEngineQuerySampleHintFn;

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

Параметры

[in, out] Pipeline

Указатель на WINBIO_PIPELINE структуру, связанную с биометрической единицей, выполняющей операцию.

[out] SampleHint

Указатель на переменную, которая получает количество обязательных выборок.

Возвращаемое значение

Если функция завершается успешно, она возвращает S_OK. Если функция завершается сбоем, она должна вернуть одно из следующих значений HRESULT , чтобы указать на ошибку.

Код возврата	Описание
E_POINTER	Обязательный параметр указателя — NULL.
WINBIO_E_UNSUPPORTED_PROPERTY	Адаптер подсистемы не поддерживает это свойство.

Если адаптеру подсистемы требуется разное количество выборок в разных ситуациях, следует вернуть наибольшее число. Например, если обработчик отпечатков пальцев требует больше прокрутки для указательного пальца, чем для большого пальца, возвращается число, необходимое для указательного пальца.

Значение, возвращаемое параметром SampleHint , указывает количество требуемых правильных выборок. Из-за неправильных записей фактическое количество выборок, необходимых во время регистрации, может быть больше указанного числа.

Примеры

В следующем псевдокоде показана одна из возможных реализаций этой функции. Пример не компилируется. Вы должны адаптировать его в соответствии с вашей целью.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	winbio_adapter.h (включая Winbio_adapter.h)

См. также раздел

EngineAdapterAcceptSampleData

Функции подключаемого модуля

Поделиться через