WIAS_ERROR makro (wiamdef.h)
Makro WIAS_ERROR menulis pesan diagnostik ke file Wiatrace.log .
Sintaks
void WIAS_ERROR(
x
);
Parameter
x
HInst - Menangani ke DLL (driver).
format_string, ... - Menentukan daftar argumen variabel, yang dimulai dengan string format ANSI yang menjelaskan pesan dan pengidentifikasi format apa pun. Elipsis (...) menentukan jumlah variabel argumen yang perlu menjadi output. Teks kesalahan harus diawali dengan nama lengkap metode atau fungsi dan menghasilkan pesan dalam format "class::method, error-text".
Nilai kembali
Tidak ada
Keterangan
Makro ini adalah cara yang disarankan untuk menerapkan pengelogan kesalahan, karena tidak seperti WIAS_LERROR, WIA_ERROR memungkinkan pesan kesalahan ditulis ke file log (Wiatrace.log). Utilitas yang digunakan untuk melihat isi file log ini WiaTrcVw.exe.
Untuk mengaktifkan pelacakan dalam build bebas, driver harus menentukan makro WIA_DEBUG dengan menambahkan #define WIA_DEBUG sebelum menyertakan salah satu header WIA. Pelacakan diaktifkan secara default dalam build sistem operasi yang dicentang dan debug.
Berikut ini adalah contoh bagaimana makro dapat digunakan:
WIAS_ERROR((g_hInst, "Failed to read (%ws) entry under %ws section of device registry",REG_ENTRY_STORAGEPATH,REG_ENTRY_DEVICEDATA));
Cuplikan kode ini diambil dari Wiadriver.cpp, yang disertakan dengan sampel driver Windows Image Acquisition (WIA) di GitHub.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamdef.h (termasuk Wiautil.h) |