IDeviceModelPlugIn::Initialize-Methode (wcsplugin.h)
Verwendet einen Zeiger auf einen Stream, der das gesamte Gerätemodell-Plug-In als Eingabe enthält, und initialisiert alle internen Parameter, die für das Plug-In erforderlich sind.
Syntax
HRESULT Initialize(
[in] BSTR bstrXml,
[in] UINT cNumModels,
[in] UINT iModelPosition
);
Parameter
[in] bstrXml
Eine Zeichenfolge, die das Plug-In-Profil des BSTR-XML-Gerätemodells enthält. Dieser Parameter speichert Daten als Little-Endian-Unicode-XML. Es kann jedoch keine führenden Bytes enthalten, um sie als solche zu markieren. Außerdem spiegelt die Codierung Schlüsselwort (keyword) im XML möglicherweise nicht wider, dass dies als Little-Endian-Unicode formatiert ist. Darüber hinaus wird die BSTR-XML-Datei aufgrund der Aktion der MSXML-Engine verarbeitet und enthält möglicherweise nicht genau den gleichen Inhalt wie die ursprüngliche XML-Datei.
[in] cNumModels
Die Anzahl der Gesamtmodelle in der Transformationssequenz.
[in] iModelPosition
Die position des einbasierten Modells des anderen Gerätemodells im Workflow von uiNumModels , wie in der Initialize-Funktion angegeben.
Rückgabewert
Wenn diese Funktion erfolgreich ist, wird der Rückgabewert S_OK.
Wenn diese Funktion fehlschlägt, wird der Rückgabewert E_FAIL.
Hinweise
Wenn diese Funktion mehrmals aufgerufen wird, geben nachfolgende Aufrufe den zugeordneten Arbeitsspeicher frei und initialisieren gemäß dem neuen bstrXml-Parameter neu.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wcsplugin.h |