IWiaMiniDrv::drvUnLockWiaDevice method (wiamindr_lh.h)

The IWiaMiniDrv::drvUnLockWiaDevice method unlocks the WIA hardware device so that any minidriver can access it.

Syntax

HRESULT drvUnLockWiaDevice(
  BYTE *__MIDL__IWiaMiniDrv0033,
  LONG __MIDL__IWiaMiniDrv0034,
  LONG *__MIDL__IWiaMiniDrv0035
);

Parameters

__MIDL__IWiaMiniDrv0033

lFlags [in]

Reserved.

__MIDL__IWiaMiniDrv0034

pWiasContext [in]

Pointer to a WIA item context.

__MIDL__IWiaMiniDrv0035

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 method IWiaMiniDrv::drvUnLockWiaDevice is used to allow access to the device after the lock is no longer needed. It is typically called by the WIA service after properties are written to the device or after a data transfer.

The minidriver's implementation of the IWiaMiniDrv::drvUnLockWiaDevice method should use the STI unlock device method IStiDevice::UnLockDevice.

Requirements

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

See also

IWiaMiniDrv

IWiaMiniDrv::drvGetDeviceErrorStr

IWiaMiniDrv::drvLockWiaDevice