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 中，相机微型驱动程序可能会分配缓存来存储项的缩略图，并将指向此缓存的指针存储在驱动程序项上下文中。 然后，微型驱动程序将在此方法中释放缓存。

要求

另请参阅

IWiaMiniDrv

IWiaMiniDrv：:d rvGetDeviceErrorStr

IWiaMiniDrv：:d rvReadItemProperties