WIAS_ERROR 매크로(wiamdef.h)

WIAS_ERROR 매크로는 Wiatrace.log 파일에 진단 메시지를 씁니다.

구문

void WIAS_ERROR(
   x
);

x

HInst - DLL(드라이버)에 대한 핸들입니다.
format_string... - 메시지 및 모든 형식 식별자를 설명하는 ANSI 형식 문자열로 시작하는 변수 인수 목록을 지정합니다. 줄임표(...)는 출력해야 하는 가변 개수의 인수를 지정합니다. 오류 텍스트는 메서드 또는 함수의 전체 이름 앞에 접두사로 지정되어야 하며 메시지를 "class::method, error-text" 형식으로 생성해야 합니다.

없음

이 매크로는 오류 로깅을 구현하는 데 권장되는 방법입니다. WIAS_LERROR 달리 WIA_ERROR 오류 메시지를 로그 파일(Wiatrace.log)에 쓸 수 있기 때문입니다. 이 로그 파일의 내용을 보는 데 사용되는 유틸리티는 WiaTrcVw.exe.

무료 빌드에서 추적을 사용하도록 설정하려면 드라이버는 WIA 헤더를 포함하기 전에 추가하여 #define WIA_DEBUG WIA_DEBUG 매크로를 정의해야 합니다. 추적은 기본적으로 운영 체제의 확인된 빌드 및 디버그에서 사용하도록 설정됩니다.

다음은 매크로를 사용하는 방법의 예입니다.

WIAS_ERROR((g_hInst, "Failed to read (%ws) entry under %ws section of device registry",REG_ENTRY_STORAGEPATH,REG_ENTRY_DEVICEDATA));

이 코드 조각은 wiadriver.cpp에서 가져온 것으로, GitHub WIA(Windows Image Acquisition) 드라이버 샘플에 포함되어 있습니다.


대상 플랫폼	데스크톱
헤더	wiamdef.h(Wiautil.h 포함)