Edit

IWiaMiniDrv::drvValidateItemProperties method (wiamindr_lh.h)

  • Article

The IWiaMiniDrv::drvValidateItemProperties method validates an item's properties against the set of valid values for each property and will update those properties if necessary.

Syntax

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

Parameters

__MIDL__IWiaMiniDrv0016

lFlags [in]

Reserved. Set to zero.

__MIDL__IWiaMiniDrv0017

nPropSpec [in]

Indicates the number of items n the pPropSpec array.

__MIDL__IWiaMiniDrv0018

pPropSpec [in]

Points to the first element of an array of PROPSPEC structures.

__MIDL__IWiaMiniDrv0019

pWiasContext [in]

Pointer to a WIA item context.

__MIDL__IWiaMiniDrv0020

plDevErrVal [out]

Points to a memory location that will receive a status code for this method. If this method returns S_OK, the value stored will be zero. Otherwise, a minidriver-specific error code will be stored at the location pointed to by this parameter.

Return value

On success, the method should return S_OK and clear the device error value pointed to by plDevErrVal. If the method fails, it should return a standard COM error code and place a minidriver-specific error code value in the memory pointed to by plDevErrVal.

The value pointed to by plDevErrVal can be converted to a string by calling IWiaMiniDrv::drvGetDeviceErrorStr.

Requirements

Requirement Value
Target Platform Desktop
Header wiamindr_lh.h (include Wiamindr.h)

See also

IWiaMiniDrv

IWiaMiniDrv::drvGetDeviceErrorStr

wiasGetItemType

wiasValidateItemProperties