макрос WIAS_ERROR (wiautil.h)
Макрос WIAS_ERROR записывает диагностическое сообщение в файл Wiatrace.log.
Синтаксис
void WIAS_ERROR(
x
);
Параметры
x
HInst — обработка библиотеки DLL (драйвера).
format_string, ... — задает список аргументов переменной, который начинается со строки формата ANSI, описывающей сообщение и любые идентификаторы формата. Многоточие (...) указывает переменное число аргументов, которые должны быть выходными. Текст ошибки должен быть префиксирован с полным именем метода или функции и создать сообщение в формате "class::method, error-text".
Возвращаемое значение
Никакой
Замечания
Этот макрос рекомендуется реализовать ведение журнала ошибок в 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 (include Wiautil.h) |