IDeviceModelPlugIn::Initialize 方法 (wcsplugin.h)
取得 Stream 的指標,其中包含整個裝置型號外掛程式作為輸入,並初始化外掛程式所需的任何內部參數。
語法
HRESULT Initialize(
[in] BSTR bstrXml,
[in] UINT cNumModels,
[in] UINT iModelPosition
);
參數
[in] bstrXml
包含 BSTR XML 裝置型號外掛程式設定檔的字串。 此參數會將資料儲存為小到尾 Unicode XML;不過,它可能沒有任何前置位元組可以標記它。 此外,XML 中的編碼關鍵字可能不會反映這格式為小到尾 Unicode。 此外,由於 MSXML 引擎的動作,系統會處理 BSTR XML 檔案,而且可能沒有與原始 XML 檔案完全相同的內容。
[in] cNumModels
轉換序列中的模型總數。
[in] iModelPosition
另一個裝置模型在 uiNumModels 工作流程中以單一為基礎的模型位置,如 Initialize 函式中提供。
傳回值
如果此函式成功,傳回值會S_OK。
如果此函式失敗,傳回值會E_FAIL。
備註
如果多次呼叫此函式,後續呼叫會釋放任何配置的記憶體,並根據新的 bstrXml 參數重新初始化。
規格需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wcsplugin.h |