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) |