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 포함) |