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