SetupWriteTextLogInfLine 호출

  • 아티클
  • 읽는 데 5분 걸림

애플리케이션은 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)

위치:

  • 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 파일 컨텍스트로 설정됩니다. 플랫폼 SDK에 설명된 SetupFindXxxLine 함수를 호출하여 줄에 대한 INF 파일 컨텍스트를 가져옵니다.

LogToken 및 LogFlags 값은 SetupWriteTextLog에 대해 설명한 것과 동일한 방식으로 SetupWriteTextLogInfLine의 작업에 영향을 줍니다. 또한 SetupWriteTextLogInfLine 은 이벤트 카탈로그 TXTLOG_INF 사용합니다.

이 예제의 경우 다음 예제에서는 SetupWriteTextLogInfLine 이 텍스트 로그에 쓸 로그 항목의 유형을 보여줍니다.

   inf:      AddReg=HidServ_AddService_AddReg  (hidserv.inf line 98)