Metode IWiaMiniDrv::d rvFreeDrvItemContext (wiamindr_lh.h)
Metode IWiaMiniDrv::d rvFreeDrvItemContext membebaskan konteks khusus perangkat.
Sintaks
HRESULT drvFreeDrvItemContext(
LONG __MIDL__IWiaMiniDrv0056,
BYTE *__MIDL__IWiaMiniDrv0057,
LONG *__MIDL__IWiaMiniDrv0058
);
Parameter
__MIDL__IWiaMiniDrv0056
lFlags [in]
Dicadangkan.
__MIDL__IWiaMiniDrv0057
pSpecContext [in]
Menunjuk ke konteks khusus perangkat.
__MIDL__IWiaMiniDrv0058
plDevErrVal [out]
Menunjuk ke lokasi memori yang akan menerima kode status untuk metode ini. Jika metode ini mengembalikan S_OK, nilai yang disimpan akan menjadi nol. Jika tidak, kode kesalahan khusus minidriver akan disimpan di lokasi yang ditujukan oleh parameter ini.
Mengembalikan nilai
Jika berhasil, metode harus mengembalikan S_OK dan menghapus nilai kesalahan perangkat yang ditunjukkan oleh plDevErrVal. Jika metode gagal, metode harus mengembalikan kode kesalahan COM standar dan menempatkan kode kesalahan khusus minidriver dalam memori yang ditunjukkan oleh plDevErrVal.
Nilai yang diarahkan oleh plDevErrVal dapat dikonversi ke string dengan memanggil IWiaMiniDrv::d rvGetDeviceErrorStr.
Keterangan
Ketika item driver dihapus, layanan WIA membebaskan konteks item driver. Metode ini menginformasikan minidriver bahwa konteks siap untuk dibebaskan. Minidriver harus membebaskan memori apa pun yang dialokasikannya untuk konteks. Misalnya, di IWiaMiniDrv::d rvReadItemProperties, minidriver kamera mungkin mengalokasikan cache untuk menyimpan gambar mini untuk item, dan menyimpan pointer ke cache ini dalam konteks item driver. Minidriver kemudian akan membebaskan cache dalam metode ini.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamindr_lh.h (termasuk Wiamindr.h) |