IWiaMiniDrv::d rvWriteItemProperties-Methode (wiamindr_lh.h)

Artikel
02/07/2025

Die IWiaMiniDrv::d rvWriteItemProperties-methode schreibt Treiberelementeigenschaften auf ein WIA-Hardwaregerät.

Syntax

HRESULT drvWriteItemProperties(
  BYTE                      *__MIDL__IWiaMiniDrv0021,
  LONG                      __MIDL__IWiaMiniDrv0022,
  PMINIDRV_TRANSFER_CONTEXT __MIDL__IWiaMiniDrv0023,
  LONG                      *__MIDL__IWiaMiniDrv0024
);

Parameter

__MIDL__IWiaMiniDrv0021

lFlags [in]

Reserviert.

__MIDL__IWiaMiniDrv0022

pWiasContext- [in]

Zeiger auf einen WIA-Elementkontext.

__MIDL__IWiaMiniDrv0023

plDevErrVal [out]

Verweist auf einen Speicherspeicherort, der einen Statuscode für diese Methode empfängt. Wenn diese Methode S_OK zurückgibt, ist der gespeicherte Wert null. Andernfalls wird ein minidriverspezifischer Fehlercode an der Position gespeichert, auf die durch diesen Parameter verwiesen wird.

__MIDL__IWiaMiniDrv0024

pmdtc [in]

Verweist auf eine MINIDRV_TRANSFER_CONTEXT Struktur, die den Geräteübertragungskontext enthält.

Rückgabewert

Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den plDevErrValverweist. Wenn die Methode fehlschlägt, sollte ein standardmäßiger COM-Fehlercode zurückgegeben und ein minidriverspezifischer Fehlercodewert im Speicher platziert werden, auf den plDevErrValverweist.

Der wert, auf den plDevErrVal verweist, kann in eine Zeichenfolge konvertiert werden, indem IWiaMiniDrv::d rvGetDeviceErrorStraufgerufen wird.