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


Метод ISensorClassExtension::Initialize (sensorsclassextension.h)

Метод ISensorClassExtension::Initialize инициализирует объект расширения класса датчика.

Синтаксис

HRESULT Initialize(
  IUnknown *pWdfDeviceUnknown,
  IUnknown *pSensorDriverUnknown
);

Параметры

pWdfDeviceUnknown

Указатель IUnknown для класса драйвера, реализующего интерфейс IWDFDevice.

pSensorDriverUnknown

Указатель IUnknown для объекта, реализующего интерфейс обратного вызова ISensorDriver.

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

Этот метод возвращает HRESULT. Возможные значения включают, помимо прочего, одно из следующих значений. См. заметки.

Код возврата Описание
S_OK Метод выполнен успешно.
E_POINTER Аргумент имел значение NULL или отсутствует интерфейс IWDFDevice .
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) Расширение класса уже инициализировано.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED) Расширение класса уже инициализировано.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Недопустимый WPD_OBJECT_ID датчика.

Комментарии

Сначала создайте расширение класса датчика, вызвав метод COM CoCreateInstance, а затем вызовите Метод Initialize. Рекомендуется выполнять эти шаги инициализации при вызове UMDF в IPnpCallbackHardware::OnPrepareHardware. После возврата инициализации драйвер должен быть готов к приему обратных вызовов из расширения класса датчика. Расширение класса датчика вызывает ISensorDriver::OnGetSupportedSensorObjects во время инициализации. Драйвер должен быть готов к возврату значений для всех обязательных свойств и полей данных, прежде чем он вызывает Initialize.

Так как расширение класса вызывает драйвер во время инициализации, этот метод также может возвращать HRESULT, возвращаемые драйвером из ISensorDriver::OnGetSupportedSensorObjects.

Требования

Требование Значение
Целевая платформа Windows
Header sensorsclassextension.h
Библиотека SensorsClassExtension.lib

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

ISensorClassExtension