ISensorClassExtension::Initialize 方法 (sensorsclassextension.h)

ISensorClassExtension::Initialize 方法初始化传感器类扩展对象。

语法

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

参数

pWdfDeviceUnknown

实现 IWDFDevice 接口的驱动程序类的 IUnknown 指针。

pSensorDriverUnknown

实现 ISensorDriver 回调接口的 对象的 IUnknown 指针。

返回值

此方法返回 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。 我们建议在 IPnpCallbackHardware::OnPrepareHardware 中由 UMDF 调用时执行这些初始化步骤。 Initialize 返回后,驱动程序必须准备好接收来自传感器类扩展的回调。 传感器类扩展在初始化期间调用 ISensorDriver::OnGetSupportedSensorObjects 。 驱动程序必须已准备好返回所有必需属性和数据字段的值,然后才能调用 Initialize。

由于类扩展在初始化期间调用驱动程序,因此此方法还可以返回驱动程序从 ISensorDriver::OnGetSupportedSensorObjects 返回的 HRESULT。

要求

要求
目标平台 Windows
标头 sensorsclassextension.h
Library SensorsClassExtension.lib

另请参阅

ISensorClassExtension