애플리케이션은 SetupWriteTextLogInfLine 을 호출하여 지정된 INF 파일 줄의 텍스트가 포함된 SetupAPI 텍스트 로그 에 로그 항목을 작성할 수 있습니다.
SetupWriteTextLogInfLine을 호출하기 위해 애플리케이션은 다음 정보를 제공합니다.
SetupGetThreadLogToken을 호출하거나 시스템 정의 로그 토큰 중 하나를 사용하여 얻은 텍스트 로그 섹션에 대한 로그 토큰입니다. 로그 토큰이 텍스트 로그 섹션과 연결된 경우 SetupWriteTextLogInfLine은 해당 섹션에 로그 항목을 기록합니다. 그렇지 않으면 SetupWriteTextLogInfLine은 텍스트 로그 섹션에 포함되지 않는 로그 부분에 로그 항목을 추가합니다.
또한 SetupWriteTextLogInfLine 이 로그 항목을 쓰는지 여부와 SetupWriteTextLogInfLine 이 항목을 쓰는 텍스트 로그는 시스템 정의 로그 토큰 값에 따라 달라집니다.
로그 토큰에 대한 자세한 내용은 스레드에 대한 로그 토큰 설정 및 가져오기를 참조하세요.
이벤트 수준, 들여쓰기 깊이 및 타임스탬프를 포함할지 여부를 지정하는 시스템 정의 상수의 비트 OR인 플래그 값입니다. 이벤트 수준은 텍스트 로그의 이벤트 수준 설정에서 설명되어 있습니다.
텍스트 로그에 대해 설정된 이벤트 수준이 항목의 이벤트 수준보다 크거나 같으면 SetupWriteTextLogInfLine 은 텍스트 로그에 로그 항목을 씁니다. 그렇지 않으면 SetupWriteTextLogInfLine 은 텍스트 로그에 로그 항목을 작성하지 않습니다. 들여쓰기를 사용하면 섹션의 정보를 더 쉽게 읽고 이해할 수 있도록 서식이 지정된 메시지를 정렬할 수 있습니다.
자세한 내용은 들여쓰기된 로그 항목 작성을 참조하세요.
INF 파일 줄이 들어 있는 INF 파일에 대한 핸들입니다.
INF 파일 줄에 대한 문맥입니다.
SetupWriteTextLogInfLine 은 다음 형식으로 로그 항목을 작성합니다.
entry_prefix time_stampinf:indentation inf-line-text(inf-file-namelineline-number)
Where:
entry_prefix, 시간 스탬프 및 들여쓰기 필드는 텍스트 로그 섹션 본문 형식에 설명된 필드와 동일합니다.
inf: 필드는 TXTLOG_INF 이벤트 범주를 지정합니다. 이벤트 범주는 텍스트 로그에 대한 이벤트 범주 활성화에 설명되어 있습니다.
inf 줄 텍스트 필드에는 지정된 INF 파일 줄의 텍스트가 포함됩니다.
inf-file-name 필드에는 지정된 INF 파일 줄이 포함된 INF 파일의 이름이 포함됩니다.
줄 필드는 다음 항목이 INF 파일의 줄 번호임을 나타냅니다.
줄 번호 필드에는 INF 파일에 지정된 줄의 줄 번호가 포함됩니다.
다음 예제에서는 애플리케이션이 일반적으로 텍스트 로그에 INF 줄의 텍스트를 기록할 수 있는 방법을 보여줍니다. 이 예제의 INF 줄은 INF AddReg 줄입니다. 애플리케이션은 SetupWriteTextLogInfLine을 호출하여 다음 입력 매개 변수 값을 전달합니다.
LogToken은 SetupGetThreadLogToken에서 반환된 로그 토큰 또는 시스템 정의 로그 토큰으로 설정됩니다.
LogFlags는 TXTLOG_DETAILS로 설정됩니다. 이 예제에서는 타임스탬프를 포함하거나 들여쓰기 깊이를 변경하지 않습니다. 이 예제에서 들여쓰기 깊이는 5개의 모노스페이스 텍스트 공백입니다.
InfHandle 은 INF 파일 hidserv.inf 에 대한 핸들로 설정됩니다. 이 핸들은 Platform SDK에 설명된 SetupOpenInfFile 함수를 호출하여 가져옵니다.
컨텍스트 는 "AddReg=HidServ_AddService_AddReg" 텍스트를 포함하는 INF 파일 줄의 INF 파일 컨텍스트로 설정됩니다. Line에 대한 INF 파일 컨텍스트는 Platform SDK에 설명된 SetupFindXxxLine 함수를 호출하여 가져옵니다.
LogToken 및 LogFlags 값은 SetupWriteTextLog에 대해 설명된 것과 동일한 방식으로 SetupWriteTextLogInfLine의 작업에 영향을 줍니다. 또한 SetupWriteTextLogInfLine은 이벤트 카탈로그 TXTLOG_INF를 사용합니다.
이 예제의 경우 다음 예제에서는 SetupWriteTextLogInfLine 이 텍스트 로그에 쓸 로그 항목의 형식을 보여줍니다.
inf: AddReg=HidServ_AddService_AddReg (hidserv.inf line 98)