Функция WbioQuerySensorInterface (winbio_adapter.h)

Статья
08/27/2023

Извлекает указатель на структуру WINBIO_SENSOR_INTERFACE для адаптера датчика.

Синтаксис

HRESULT WbioQuerySensorInterface(
  [out] PWINBIO_SENSOR_INTERFACE *SensorInterface
);

Параметры

[out] SensorInterface

Адрес переменной, получающей указатель на структуру WINBIO_SENSOR_INTERFACE .

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

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

Код возврата	Описание
E_POINTER	Параметр SensorInterface не может иметь значение NULL.

Windows Biometric Framework вызывает эту функцию после загрузки библиотеки DLL адаптера датчика в память. Поэтому каждая библиотека DLL адаптера датчика должна реализовывать и экспортировать функцию WbioQueryEngineInterface . Имя функции учитывает регистр, а ее написание и подпись должны в точности соответствовать описанию, приведенному в разделе Синтаксис.

Чтобы быть видимым для Windows Biometric Framework, функция WbioQueryEngineInterface должна быть названа в разделе EXPORTS файла команды компоновщика определения экспорта для библиотеки DLL.

Примеры

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

HRESULT
WINAPI
WbioQuerySensorInterface(
    __out PWINBIO_SENSOR_INTERFACE *SensorInterface
    )
{
    // g_SensorInterface is a global variable.
    *SensorInterface = &g_SensorInterface;
    return S_OK;
}

Требования


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

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

Функции подключаемых модулей

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