IWiaPropertyStorage::SetPropertyStream-Methode (wia_xp.h)

IWiaPropertyStorage::SetPropertyStream legt den Eigenschaftenstream eines Elements in der Struktur von IWiaItem-Objekten eines WINDOWS-Hardwaregeräts für die Bilderfassung (Windows Image Acquisition, WIA) fest.

Syntax

HRESULT SetPropertyStream(
  [in] GUID    *pCompatibilityId,
  [in] IStream *pIStream
);

Parameter

[in] pCompatibilityId

Typ: GUID*

Gibt einen eindeutigen Bezeichner für einen Satz von Eigenschaftswerten an.

[in] pIStream

Typ: IStream*

Zeiger auf den Eigenschaftenstream, der zum Festlegen des Eigenschaftendatenstroms des aktuellen Elements verwendet wird.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Anwendungen verwenden den pCompatibilityID-Parameter , um zu überprüfen, ob ein Gerät einen bestimmten Satz von Eigenschaftswerten unterstützt, bevor sie versuchen, diese Werte auf das Gerät zu schreiben.

Legen Sie pIStream auf NULL fest, um zu überprüfen, ob der Gerätetreiber die von pCompatibilityID angegebene CompatibilityID akzeptiert.

Wenn die Anwendung den Eigenschaftendatenstrom des Elements mithilfe der IWiaPropertyStorage::GetPropertyStream-Methode abgerufen hat, muss die Anwendung ihn freigeben. Weitere Informationen finden Sie unter IStream.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wia_xp.h (wia.h einschließen)
Bibliothek Wiaguid.lib
DLL Wiaservc.dll

Weitere Informationen

IPropertyStorage

IWiaPropertyStorage