IWiaMiniDrv::drvInitItemProperties method (wiamindr_lh.h)

Article
02/22/2024

The IWiaMiniDrv::drvInitItemProperties method initializes WIA driver item properties for each item in an application item tree.

Syntax

HRESULT drvInitItemProperties(
  BYTE *__MIDL__IWiaMiniDrv0013,
  LONG __MIDL__IWiaMiniDrv0014,
  LONG *__MIDL__IWiaMiniDrv0015
);

Parameters

__MIDL__IWiaMiniDrv0013

lFlags [in]

Reserved. Set to zero.

__MIDL__IWiaMiniDrv0014

pWiasContext [in]

Pointer to a WIA item context.

__MIDL__IWiaMiniDrv0015

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.

Remarks

The IWiaMiniDrv::drvInitItemProperties method is called once per application for each item in the item tree.

Requirements

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