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,則儲存的值會是零。 否則,minidriver 特定的錯誤碼會儲存在此參數所指向的位置。
傳回值
成功時,方法應該會傳回 S_OK ,並清除 plDevErrVal 所指向的裝置錯誤值。 如果方法失敗,它應該會傳回標準 COM 錯誤碼,並將minidriver特定錯誤碼放在 plDevErrVal 所指向的記憶體中。
plDevErrVal 所指向的值可以藉由呼叫 IWiaMiniDrv::d rvGetDeviceErrorStr 來轉換成字符串。
備註
刪除驅動程式專案時,WIA 服務會釋放驅動程式項目內容。 這個方法會通知 minidriver 內容已準備好釋出。 minidriver 應該釋放它配置給內容的任何記憶體。 例如,在 IWiaMiniDrv::d rvReadItemProperties 中,相機迷你驅動程式可能會配置快取來儲存專案的縮圖,並將此快取的指標儲存在驅動程式項目內容中。 minidriver 接著會在此方法中釋放快取。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | wiamindr_lh.h (包括 Wiamindr.h) |