макрос WIAS_TRACE (wiamdef.h)
Макрос WIAS_TRACE записывает диагностическое сообщение в файл Wiatrace.log.
Синтаксис
void WIAS_TRACE(
x
);
Параметры
x
HInst — обработка библиотеки DLL (драйвера).
format_string, ... — задает список аргументов переменной, который начинается со строки формата ANSI, описывающей сообщение и любые идентификаторы формата. Многоточие (...) указывает переменное число аргументов, которые должны быть выходными. Текст ошибки должен быть префиксирован с полным именем метода или функции и создать сообщение в формате "class::method, error-text".
Возвращаемое значение
Никакой
Замечания
Чтобы включить трассировку в бесплатных сборках, драйверы должны определить макрос WIA_DEBUG путем добавления #define WIA_DEBUG перед включением любого из заголовков WIA. Трассировка включена по умолчанию в проверяемых и отладочных сборках операционной системы.
Ниже приведен пример использования макроса:
WIAS_TRACE((g_hInst,"WIA storage path = %ws",m_wszStoragePath));
Этот фрагмент кода был взят из Wiadriver.cpp, который включен в примеры драйверов приобретения образов Windows (WIA) на GitHub.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | wiamdef.h (include Wiautil.h) |