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

Artikel
02/27/2024

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 status Code für diese Methode erhält. Wenn diese Methode S_OK zurückgibt, ist der gespeicherte Wert null. Andernfalls wird ein minidriverspezifischer Fehlercode an der Stelle gespeichert, auf die dieser Parameter verweist.

__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 plDevErrVal verweist. Wenn die Methode fehlschlägt, sollte sie einen standardmäßigen COM-Fehlercode zurückgeben und einen minidriver-spezifischen Fehlercodewert im Speicher platzieren, auf den plDevErrVal verweist.

Der Wert, auf den plDevErrVal verweist, kann in eine Zeichenfolge konvertiert werden, indem IWiaMiniDrv::d rvGetDeviceErrorStr aufgerufen wird.