IDeviceModelPlugIn::Initialize 方法 (wcsplugin.h)
将指向包含整个设备模型插件的 Stream 的指针作为输入,并初始化插件所需的任何内部参数。
语法
HRESULT Initialize(
[in] BSTR bstrXml,
[in] UINT cNumModels,
[in] UINT iModelPosition
);
参数
[in] bstrXml
包含 BSTR XML 设备模型插件配置文件的字符串。 此参数将数据存储为 little-endian Unicode XML;但是,它可能没有前导字节来标记它。 此外,XML 中的编码关键字 (keyword) 可能不会反映这被格式化为 little-endian Unicode。 此外,由于 MSXML 引擎的操作,BSTR XML 文件将得到处理,并且可能不具有与原始 XML 文件完全相同的内容。
[in] cNumModels
转换序列中模型总数。
[in] iModelPosition
uiNumModels 工作流中其他设备模型的基于一个的模型位置,如 Initialize 函数中提供。
返回值
如果此函数成功,则返回值S_OK。
如果此函数失败,则返回值E_FAIL。
注解
如果多次调用此函数,则后续调用会释放任何分配的内存,并根据新的 bstrXml 参数重新初始化。
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | wcsplugin.h |