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

另请参阅