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 |