Поделиться через


макрос WIAS_ASSERT (wiamdef.h)

Макрос WIAS_ASSERT записывает диагностическое сообщение в файл Wiatrace.log .

Синтаксис

void WIAS_ASSERT(
   x,
   y
);

Параметры

x

Задает любое логическое выражение.

y

Дескриптор в библиотеку DLL (драйвер).

Возвращаемое значение

None

Remarks

Макрос WIAS_ASSERT используется для отладки драйверов WIA. Он используется для проверки выполнения определенного условия. Если параметр Expression имеет значение TRUE, этот макрос ничего не делает. Если значение Expression принимает значение FALSE, макрос выводит строку ошибки в файл журнала диагностики Wiatrace.log . Это сообщение об ошибке будет содержать имя и путь к вызывающей драйверу, а также номер строки в исходном коде драйвера, в котором произошел сбой макроса WIAS_ASSERT.

Макрос WIAS_ASSERT доступен в Windows Vista и более поздних версиях операционной системы. Этот макрос является рекомендуемым способом реализации утверждений WIA в Windows Vista. WIAS_ASSERT позволяет записывать сообщения об ошибках в файл журнала (Wiatrace.log). Файл Wiatrace.log доступен только в Windows Vista и более поздних версиях операционной системы. Служебная программа, используемая для просмотра содержимого этого файла журнала, WiaTrcVw.exe.

Чтобы включить утверждения в бесплатных сборках, драйверы должны определить макрос WIA_DEBUG путем добавления #define WIA_DEBUG в исходный код драйвера. Это необходимо сделать перед включением любого из заголовков WIA. Утверждения включены по умолчанию в проверенных и отладочных сборках операционной системы.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть wiamdef.h (включая Wiautil.h)

См. также раздел

WIAS_ERROR

WIAS_HRESULT

WIAS_TRACE