텍스트 로그 섹션 본문의 형식
텍스트 로그 섹션 본문에는 텍스트 로그 섹션과 연결된 작업에 적용되는 0개 이상의 로그 항목이 포함되어 있습니다. 섹션 본문 로그 항목의 형식에는 다음과 같이 entry_prefix 필드, time_stamp 필드, event_category 필드, 들여쓰기 필드 및 formatted_message 필드가 포함됩니다.
entry_prefix time_stamp event_category 들여쓰기 formatted_message
섹션 본문 로그 항목의 최대 길이(문자)는 336입니다.
entry_prefix 필드
로그 항목이 오류 메시지, 경고 메시지 또는 정보 메시지인지 여부를 나타냅니다.
entry_prefix 필드는 항상 존재하며 다음 표에 나열된 문자열 중 하나를 포함합니다.
Entry_prefix 필드 | 메시지 유형 |
---|---|
"!!! " | 오류 메시지 |
"! " | 경고 메시지 |
" " | 오류 메시지 또는 경고 메시지 이외의 정보 메시지 |
time_stamp 필드
기록된 이벤트가 발생한 시스템 시간을 나타냅니다.
time_stamp 필드는 선택 사항이며 SetupAPI에는 기본적으로 타임스탬프를 포함하지 않습니다. 그러나 SetupWriteTextLog 는 로그 항목에 타임스탬프를 포함할 수 있습니다.
time_stamp 필드의 형식은 텍스트 로그 섹션 머리글 형식에 설명된 time_stamp 필드의 형식과 동일합니다.
event_category 필드
로그 항목을 만든 SetupAPI 작업의 범주를 나타냅니다.
event_category 필드는 일반적으로 존재하지만 필수는 아닙니다.
event_category 필드가 있으면 다음 표에 나열된 문자열 중 하나가 포함됩니다.
필드 문자열 Event_category | SetupAPI 작업 |
---|---|
"...: " | 공급업체에서 제공하는 작업 |
"박: " | 백업 데이터 |
"cci: " | 클래스 설치 관리자 또는 공동 설치 관리자 작업 |
"cpy: " | 파일 복사 |
"dvi: " | 장치 설치 |
"flq: " | 파일 큐 관리 |
"inf: " | INF 파일 관리 |
"ndv: " | 새 디바이스 마법사 |
"prp: " | 디바이스 및 드라이버 속성 관리 |
"reg: " | 레지스트리 설정 관리 |
"set: " | 일반 설정 |
"sig: " | 디지털 서명 확인 |
"sto: " | 드라이버 저장소 관리 |
"ui: " | 사용자 인터페이스 관리 대화 상자 |
"ump: " | 사용자 모드 PnP 관리자 |
들여쓰기 필드
들여쓰기 단위가 5개의 공백을 포함하는 모노스페이스 문자열인 0개 이상의 들여쓰기 단위 시퀀스로 구성됩니다.
들여쓰기 필드는 선택 사항이며 SetupAPI에는 기본적으로 들여쓰기가 포함되지 않습니다.
SetupWriteTextLog 는 로그 항목에 포함된 들여쓰기 단위 수를 변경할 수 있도록 지원합니다.
formatted_message 필드
로그 항목에 적용되는 특정 정보를 포함합니다.
기록되는 섹션 본문 항목은 로그에 대해 설정된 이벤트 수준 및 로그에 대해 사용하도록 설정된 범주 수준에 따라 달라집니다. 이러한 설정에 대한 자세한 내용은 SetupAPI 로깅 레지스트리 설정을 참조하세요.
SetupAPI는 디바이스 설치에 적용되는 작업을 그룹화하는 섹션을 만들 때 하위 섹션에서 섹션 본문 로그 항목을 재귀적으로 그룹화합니다. SetupAPI는 로그 항목에 주석을 달고 들여쓰는 방식으로 하위 섹션을 구분합니다. 이러한 하위 섹션 중 하나는 일반적인 디바이스 설치 섹션에서 발췌한 다음 섹션에 나타납니다. 하위 섹션은 로그 항목 "dvi: {Build Driver List}"로 시작하고 로그 항목 "dvi: {Build Driver List - exit(0x00000000)}"로 끝납니다. 이 하위 섹션에서는 entry_prefix, event_category, 들여쓰기및formatted_message 필드를 포함하는 일반적인 로그 항목 시퀀스를 보여 줍니다. 로그 항목을 작성한 SetupAPI 작업에서도 들여쓰기를 만들고 형식이 지정된 메시지의 콘텐츠를 제공했습니다. 이 예제의 이벤트 수준은 TXTLOG_DETAILS 설정되었으며 이 예제에서는 모든 범주 수준을 사용하도록 설정했습니다.
>>> [Device Install - PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38]
>>> 2005/02/13 22:06:28.109: Section start
...
Additional section body log entries
...
dvi: {Build Driver List}
dvi: Enumerating all INFs...
dvi: Found driver match:
dvi: HardwareID - PCI\VEN_104C&DEV_8019
dvi: InfName - C:\WINDOWS\inf\1394.inf
dvi: DevDesc - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
dvi: DrvDesc - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
dvi: Provider - Microsoft
dvi: Mfg - Texas Instruments
dvi: InstallSec - TIOHCI_Install
dvi: ActualSec - TIOHCI_Install.NT
dvi: Rank - 0x00002001
dvi: DrvDate - 10/01/2002
dvi: Version - 6.0.5033.0
!!! inf: InfCache: Error flagging 1394.inf for match string pci\ven_104c&dev_8019
dvi: {Build Driver List - exit(0x00000000)}
...
Additional section body log entries
...
<<< [2005/02/13 22:06:29.000: Section end]
<<< [Exit Status(0x00000000)]