다음을 통해 공유


드라이버 프로젝트에 대한 메시지 컴파일러 속성

메시지 컴파일러(MC.exe) 도구의 속성을 설정합니다. 컴파일러는 프로젝트에 추가할 수 있는 메시지 리소스 파일을 생성합니다.

예를 들어 ETW(Windows용 이벤트 추적) 커널 모드 API를 사용하여 이벤트 추적을 커널 모드 드라이버에 추가하는 경우 메시지 컴파일러를 사용하여 이벤트 공급자, 이벤트 특성, 채널 및 이벤트에 대한 정의가 포함된 헤더 파일을 만들 수 있습니다. 소스 코드에 이 헤더 파일을 포함해야 합니다. 메시지 컴파일러는 프로젝트 파일에 추가하는 리소스 컴파일러 스크립트(*.rc)를 만듭니다.

드라이버 프로젝트에 대한 메시지 컴파일러 속성 설정

  1. 드라이버 프로젝트의 속성 페이지를 엽니다. 솔루션 탐색기 드라이버 프로젝트를 선택하고 길게 누르거나 마우스 오른쪽 단추클릭하고 속성을 선택합니다.
  2. 드라이버 프로젝트의 속성 페이지에서 구성 속성을 선택한 다음 메시지 컴파일러를 선택합니다.
  3. 프로젝트의 속성을 설정합니다.

이 속성 페이지는 솔루션에 메시지 텍스트 파일(.mc) 또는 매니페스트(.man)를 추가하는 경우 사용할 수 있습니다.

옵션 설명

추가 옵션

메시지 컴파일러(MC.exe) 도구에 전달할 추가 옵션을 지정합니다.

Ansi 입력 파일

입력 파일에 ANSI 콘텐츠가 포함되도록 지정합니다(기본값). (-a)

Bin 파일의 Ansi 메시지

출력 .bin 파일의 메시지가 ANSI여야 임을 지정합니다. (-A)

기준 경로

경로는 .을 포함하는 폴더를 가리킬 수 있어야 합니다. 기준 작업에서 만든 BIN 파일입니다. (-t 디렉터리)

초기 계획 리소스 경로

기준 매니페스트 파일이 포함된 폴더입니다. (-s 디렉터리)

출력 경로 디버그

.dbg C 포함 파일을 배치할 경로입니다. (-x 경로)

설명선 매크로 사용

로깅 시 사용자 코드를 호출하는 설명선 매크로를 추가합니다. C#에 사용할 수 없으며 무시됩니다. (-co)

디버그 출력 경로 사용

컴파일러가 디버그 출력 경로 속성에 지정된 .dbg C include 파일을 배치할 수 있도록 합니다.

생성된 헤더의 파일 확장명입니다.

생성된 헤더 파일의 확장자를 지정합니다. (-e 확장)

기준 리소스 생성

계측 기준을 만듭니다.

C#(관리형) 로깅 클래스 생성

매니페스트에서 이벤트를 로그하기 위해 호출하는 메서드를 포함하는 C#(관리형) 로깅 클래스를 생성합니다. (-cs 네임스페이스)

카운터 이름 및 GUID를 포함하기 위한 헤더 파일 생성

이 옵션을 사용하여 컴파일러에서 생성된 헤더 파일을 배치할 폴더를 지정할 수 있습니다.

커널 모드 로깅 매크로 생성

커널 모드 로깅 매크로를 생성합니다. (-km)

MOF 파일 생성

생성된 모든 함수 및 매크로에 대한 하위 수준 지원을 생성합니다. 매니페스트에서 MOF 파일이 생성됩니다. MOF 파일은 -h 옵션(-mof)으로 지정된 위치에 배치됩니다.

OLE2 헤더 생성

OLE2 헤더 파일을 생성합니다. (-o)

정적 C#(관리형) 로깅 클래스 생성

매니페스트에서 이벤트를 로그하기 위해 호출하는 메서드를 포함하는 정적 C#(관리형) 로깅 클래스를 생성합니다. (-css 네임스페이스)

사용자 모드 로깅 매크로 생성

사용자 모드 로깅 매크로를 생성합니다. (-um)

생성된 파일 기본 이름

생성된 모든 파일의 기본 이름을 지정합니다. (-z basename)

생성된 RC 및 이진 메시지 파일 경로

생성된 RC 및 이진 메시지 파일의 경로를 지정합니다.

헤더 파일 경로

생성된 헤더 파일의 경로를 지정합니다. (-h 경로)

최대 메시지 길이

이 인수를 사용하여 메시지가 길이 문자를 초과하는 경우 컴파일러가 경고를 생성하도록 합니다. (-m 길이)

접두사 매크로 이름

이 인수를 사용하여 컴파일러가 로깅 매크로 이름 및 메서드 이름에 사용하는 기본 접두사를 재정의합니다. (-p 접두사)

RC 파일 경로

컴파일러에서 생성된 리소스 컴파일러 스크립트(.rc 파일) 및 생성된 .bin 파일을 배치할 폴더입니다. (-r 경로)

기호 이름에서 문자 제거

이 인수를 사용하여 이벤트에 대해 지정한 기호 이름의 시작 부분에서 문자를 제거합니다. (-P 접두사)

고객 비트 설정

전체 메시지 ID에서 Customer 비트를 설정합니다. (-c)

Null로 메시지 종료

메시지 테이블에서 null을 사용하여 모든 문자열을 종료합니다. (-n)

유니코드 입력 파일

입력 파일에 유니코드 콘텐츠가 포함되도록 지정합니다. (-u)

기본값은 ANSI입니다.

Bin 파일의 유니코드 메시지

출력 .bin 파일의 메시지가 유니코드임을 지정합니다. (-U)

기본값입니다.

입력의 기본 이름 사용

이 인수를 사용하여 컴파일러가 출력 .bin 파일의 이름에 입력 파일의 기본 이름을 사용하도록 합니다. (-b)

10진수 값 사용

헤더 파일에서 16진수 값 대신 심각도 및 Facility 상수에 10진수 값을 사용하려면 이 인수를 사용합니다. (-d)

기준 리소스에 대한 유효성 검사

매니페스트의 새 버전을 만들고 -s 옵션을 사용하여 만든 기준과 애플리케이션 호환성을 확인하려는 경우 이 인수를 사용합니다.

자세한 정보 표시

자세한 출력을 생성하려면 이 옵션을 사용합니다. (-v)