WIAS_ERROR makro (wiautil.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 pada Windows Vista, karena tidak seperti WIAS_LERROR, WIA_ERROR memungkinkan pesan kesalahan ditulis ke file log (Wiatrace.log). File Wiatrace.log hanya tersedia di Windows Vista dan versi sistem operasi yang lebih baru. 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 |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows Vista dan versi sistem operasi yang lebih baru. |
| Target Platform | Desktop |
| Header | wiautil.h (termasuk Wiautil.h) |