Metode IWiaMiniDrv::d rvGetDeviceErrorStr (wiamindr_lh.h)

Artikel
02/27/2024

Metode IWiaMiniDrv::d rvGetDeviceErrorStr memetakan kode kesalahan ke string Unicode yang menjelaskan kesalahan.

Sintaks

HRESULT drvGetDeviceErrorStr(
  LONG     __MIDL__IWiaMiniDrv0039,
  LONG     __MIDL__IWiaMiniDrv0040,
  LPOLESTR *__MIDL__IWiaMiniDrv0041,
  LONG     *__MIDL__IWiaMiniDrv0042
);

Parameter

__MIDL__IWiaMiniDrv0039

lDevErrVal [in]

Menentukan nilai kesalahan perangkat yang akan dipetakan ke string. Nilai nol menunjukkan bahwa tidak ada kesalahan yang terjadi.

__MIDL__IWiaMiniDrv0040

lFlags [in]

Dicadangkan.

__MIDL__IWiaMiniDrv0041

plDevErr [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.

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out, opsional]

Menunjuk ke lokasi memori yang akan menerima alamat string yang menjelaskan kesalahan.

Mengembalikan nilai

Jika berhasil, metode harus mengembalikan S_OK dan menghapus nilai kesalahan perangkat yang ditunjukkan oleh plDevErr. Jika minidriver tidak sepenuhnya menerapkan metode ini, metode harus mengembalikan E_NOTIMPL. Jika minidriver tidak mengenali nilai kesalahan yang diteruskan ke metode ini, metode harus mengembalikan E_INVALIDARG. Jika metode gagal, metode harus mengembalikan kode kesalahan COM standar dan menempatkan nilai kode kesalahan khusus minidriver dalam memori yang ditunjukkan oleh plDevErr.

Keterangan

Untuk mendapatkan string kesalahan yang menjelaskan nilai kesalahan yang dihasilkan minidriver khusus perangkat, layanan WIA memanggil metode IWiaMiniDrv::d rvGetDeviceErrorStr . Menanggapi panggilan ini, minidriver harus menggunakan CoTaskMemAlloc untuk mengalokasikan memori yang akan berisi string Unicode lokal yang sesuai dengan kode kesalahan yang diteruskan ke minidriver. Layanan WIA (atau aplikasi) akan membebaskan memori. Kemungkinan aplikasi akan menampilkan string, sehingga harus bermakna bagi pengguna akhir. String harus dimuat dari file sumber daya, sehingga dapat dilokalkan ke dalam berbagai bahasa.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	wiamindr_lh.h (termasuk Wiamindr.h)

Bagikan melalui