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

Artikel
02/07/2025

Die IWiaMiniDrv::d rvValidateItemProperties Methode überprüft die Eigenschaften eines Elements anhand des Satzes gültiger Werte für jede Eigenschaft und aktualisiert diese Eigenschaften bei Bedarf.

Syntax

HRESULT drvValidateItemProperties(
  BYTE           *__MIDL__IWiaMiniDrv0016,
  LONG           __MIDL__IWiaMiniDrv0017,
  ULONG          __MIDL__IWiaMiniDrv0018,
  const PROPSPEC *__MIDL__IWiaMiniDrv0019,
  LONG           *__MIDL__IWiaMiniDrv0020
);

Parameter

__MIDL__IWiaMiniDrv0016

lFlags [in]

Reserviert. Auf Null festgelegt.

__MIDL__IWiaMiniDrv0017

nPropSpec [in]

Gibt die Anzahl der Elemente n des pPropSpec- Arrays an.

__MIDL__IWiaMiniDrv0018

pPropSpec [in]

Verweist auf das erste Element eines Arrays von PROPSPEC- Strukturen.

__MIDL__IWiaMiniDrv0019

pWiasContext- [in]

Zeiger auf einen WIA-Elementkontext.

__MIDL__IWiaMiniDrv0020

plDevErrVal [out]

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

Rückgabewert

Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den durch plDevErrValverwiesen wurde. 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.