макрос WIAS_ERROR (wiautil.h)
Макрос WIAS_ERROR записывает диагностическое сообщение в файл Wiatrace.log .
Синтаксис
void WIAS_ERROR(
x
);
Параметры
x
HInst — дескриптор в библиотеке DLL (драйвер).
format_string, ... — задает список аргументов переменной, который начинается со строки формата ANSI, описывающей сообщение и любые идентификаторы формата. Многоточие (...) указывает переменное число аргументов, которые должны быть выведены. Текст ошибки должен иметь префикс с полным именем метода или функции и создать сообщение в формате "class::method, error-text".
Возвращаемое значение
None
Remarks
Этот макрос является рекомендуемой для реализации ведения журнала ошибок в Windows Vista, так как в отличие от WIAS_LERROR, WIA_ERROR позволяет записывать сообщения об ошибках в файл журнала (Wiatrace.log). Файл Wiatrace.log доступен только в Windows Vista и более поздних версиях операционной системы. Служебная программа, используемая для просмотра содержимого этого файла журнала, WiaTrcVw.exe.
Чтобы включить трассировку в бесплатных сборках, драйверы должны определить макрос WIA_DEBUG, добавив #define WIA_DEBUG перед включением любого из заголовков WIA. Трассировка включена по умолчанию в проверенных и отладочных сборках операционной системы.
Ниже приведен пример использования макроса.
WIAS_ERROR((g_hInst, "Failed to read (%ws) entry under %ws section of device registry",REG_ENTRY_STORAGEPATH,REG_ENTRY_DEVICEDATA));
Этот фрагмент кода взят из Wiadriver.cpp, который входит в состав примеров драйверов для получения образов Windows (WIA) на сайте GitHub.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях операционной системы. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wiautil.h (включая Wiautil.h) |