IWiaMiniDrv::d rvFreeDrvItemContext 方法 (wiamindr_lh.h)

IWiaMiniDrv::d rvFreeDrvItemContext 方法释放特定于设备的上下文。

语法

HRESULT drvFreeDrvItemContext(
  LONG __MIDL__IWiaMiniDrv0056,
  BYTE *__MIDL__IWiaMiniDrv0057,
  LONG *__MIDL__IWiaMiniDrv0058
);

参数

__MIDL__IWiaMiniDrv0056

lFlags [in]

保留。

__MIDL__IWiaMiniDrv0057

pSpecContext [in]

指向特定于设备的上下文。

__MIDL__IWiaMiniDrv0058

plDevErrVal [out]

指向将接收此方法的状态代码的内存位置。 如果此方法返回 S_OK,则存储的值将为零。 否则,微型驱动程序特定的错误代码将存储在此参数指向的位置。

返回值

成功后,方法应返回 S_OK 并清除 plDevErrVal 指向的设备错误值。 如果方法失败,它应返回标准 COM 错误代码,并在 plDevErrVal 指向的内存中放置一个特定于微型驱动程序的错误代码。

plDevErrVal 指向的值可以通过调用 IWiaMiniDrv::d rvGetDeviceErrorStr 转换为字符串。

注解

删除驱动程序项时,WIA 服务将释放驱动程序项上下文。 此方法通知微型驱动程序上下文已准备好释放。 微型驱动程序应释放为上下文分配的任何内存。 例如,在 IWiaMiniDrv::d rvReadItemProperties 中,相机微型驱动程序可能会分配缓存来存储项的缩略图,并将指向此缓存的指针存储在驱动程序项上下文中。 然后,微型驱动程序将在此方法中释放缓存。

要求

要求
目标平台 桌面
标头 wiamindr_lh.h (包括 Wiamindr.h)

另请参阅

IWiaMiniDrv

IWiaMiniDrv::d rvGetDeviceErrorStr

IWiaMiniDrv::d rvReadItemProperties