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));
이 코드 조각은 GitHub의 WIA(Windows Image Acquisition) 드라이버 샘플에 포함된 Wiadriver.cpp 가져온 것입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | wiamdef.h(Wiautil.h 포함) |