기존 원본 파일에서 드라이버 만들기
WDK(Windows 드라이버 키트) 8부터 WDK는 Microsoft Visual Studio와 완벽하게 통합되었습니다. 이제 WDK는 Visual Studio 솔루션 및 프로젝트를 빌드하는 데 사용하는 것과 동일한 컴파일러 및 빌드 도구를 사용합니다. MSBuild는 WDK의 이전 버전(WDK 8 이전)에서 사용되었던 Windows 빌드 유틸리티(Build.exe)를 대신합니다. 이전 버전의 WDK를 사용하여 만든 드라이버가 있으면 기존 코드에서 손쉽게 Visual Studio 프로젝트 및 솔루션을 만들 수 있습니다.
중요 WDK 8으로 만든 프로젝트 및 솔루션은 WDK(Windows 드라이버 키트) 8.1 및 Microsoft Visual Studio 2013에서 작동하도록 업그레이드해야 합니다. 프로젝트 또는 솔루션을 열기 전에 ProjectUpgradeTool을 실행합니다. ProjectUpgradeTool은 WDK 8.1을 사용하여 빌드할 수 있도록 프로젝트 및 솔루션을 변환합니다.
WDK는 드라이버의 sources, dirs 및 makefile.inc 파일에서 Visual Studio 솔루션 및 프로젝트를 생성하는 변환 유틸리티를 제공합니다. 이 유틸리티는 기존 sources 파일과 동일한 디렉터리에 Visual Studio 솔루션 및 프로젝트 파일을 만듭니다. 이 유틸리티는 소스 코드나 이전 빌드 파일은 바꾸지 않습니다. Windows XP에서 드라이버를 지원해야 할 경우 이전 Windows XP용 빌드 시스템을 계속 사용하고 WDK 8.1 또는 WDK 8과 Windows 8.1, Windows 8, Windows 7, Windows Vista용 Visual Studio 프로젝트 및 솔루션 파일을 사용할 수 있습니다.
기존 원본 파일에서 Visual Studio 드라이버 프로젝트를 만들기 위한 옵션은 다음과 같습니다.
- Visual Studio를 사용하여 (sources 및 dirs 파일을 기반으로 하는) 기존 드라이버 프로젝트를 열고 변환하도록 선택
- Visual Studio 명령 프롬프트 창을 열고 WDK sources 및 dirs 파일 변환기(Nmake2MsBuild.exe) 사용
- (Recommended) Visual Studio에서 제공된 Windows 드라이버 템플릿 중 하나를 사용하여 새 Windows 드라이버 솔루션을 만듭니다. 드라이버 모델에 대한 템플릿을 사용하여 시작하는 경우 프로젝트 구조는 그대로 유지되고 올바른 플랫폼 도구 집합이 선택됩니다. 그런 다음 소스 파일을 솔루션에 추가할 수 있습니다. 템플릿 선택에 대한 자세한 내용은 새 장치 함수 드라이버 만들기, 새 필터 드라이버 만들기 또는 새 소프트웨어 드라이버 만들기를 참조하세요.
이전 버전의 WDK로 만든 드라이버 프로젝트를 열고 변환하려면(파일 > 열기)
Microsoft Visual Studio Ultimate 2012를 엽니다. 파일 메뉴에서 열기를 클릭한 다음 원본/디렉터리 변환을 클릭합니다.
열기 대화 상자에서 드라이버에 대한 sources 또는 dirs 파일이 있는 디렉터리로 이동하고 파일을 선택한 다음 열기를 클릭합니다. Visual Studio Ultimate 2012의 출력 창에 Visual Studio 프로젝트의 변환 및 만들기에 대한 정보 메시지가 표시됩니다. sources 파일의 요소가 변화된 과정에 대한 세부 정보를 보려면 변환 로그(Nmake2MsBuild_sources.log)를 참조할 수 있습니다. 변환의 일부로, 로그 파일을 열어서 볼 것인지 묻는 메시지가 표시됩니다.
솔루션 탐색기에서 프로젝트를 확인합니다.
UMDF 드라이버를 변환하는 경우 추가 단계를 참조하세요.
기존 코드에서 드라이버 프로젝트를 만들려면(명령줄)
Visual Studio 명령 프롬프트 창을 엽니다. 프로젝트가 %PROGRAMFILES%에 있으면 관리자 권한을 사용(관리자 권한으로 실행)하여 명령 프롬프트 창을 열어야 합니다.
Nmake2MsBuild 변환 유틸리티(Nmake2MsBuild.exe)를 실행하고 드라이버에 대한 sources 또는 dirs 파일의 이름과 경로를 지정합니다.
한 번에 둘 이상의 sources 파일을 지정할 수 있습니다. 모든 결과 프로젝트는 동일한 솔루션 및 패키지 프로젝트를 공유합니다.
dirs 파일에 대해 Nmake2MsBuild 유틸리티를 실행하면 모든 sources 파일의 디렉터리 트리가 트래버스되고 각 파일의 Visual Studio 프로젝트 파일이 생성됩니다.
변환 도구는 %PROGRAMFILES%\Windows Kits\8.0\bin\x86\ 디렉터리에 있습니다.
예를 들어, C:\Myproj 디렉터리의 기존 sources 파일에 대해 Visual Studio 프로젝트 파일을 생성하려면 다음 명령을 입력합니다.
Nmake2MsBuild.exe c:\myProj\sources
Visual Studio에서 프로젝트 파일(*.vcxproj) 또는 솔루션 파일(*.sln)을 열어 변환을 확인합니다. Visual Studio를 시작하고 열기를 클릭한 다음 sources 파일을 변환한 디렉터리로 이동합니다. 기본 빌드 구성을 사용하여 프로젝트 필드를 시도합니다.
유틸리티는 변환된 프로젝트 파일을 확인하거나 문제를 해결해야 할 때 사용할 수 있는 로그 파일을 만듭니다. 기본 로그 파일은 Nmake2MSBuild_sources.log라고 합니다. 로그 파일은 오류 및 경고를 보고하며, 원본 파일의 요소가 Visual Studio 프로젝트로 해석되고 변환되는 방법에 대해서도 설명합니다.
UMDF 드라이버를 변환하는 경우 추가 단계를 참조하세요.
Nmake2MsBuild 유틸리티
변환 도구는 %PROGRAMFILES%\Windows Kits\8.0\bin\x86\ 디렉터리에 있습니다. 변환 유틸리티 및 옵션 사용에 대한 자세한 내용은 Nmake2MsBuild를 참조하세요.
UMDF 드라이버를 변환하는 경우 추가 단계
기본적으로 변환 유틸리티는 커널 디버거(Windows용 디버깅 도구 - 커널 디버거)를 사용하도록 드라이버 패키지 프로젝트를 구성합니다. UMDF 드라이버를 Visual Studio 솔루션으로 변환하는 경우 사용자 모드(원격) 디버거를 대신 사용할 수 있도록 이 설정을 변경해야 합니다.
사용자 모드(원격) 디버거를 지정하려면
- 드라이버 프로젝트의 속성 페이지를 엽니다. 솔루션 탐색기에서 드라이버 패키지 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다.
- 드라이버 패키지 프로젝트의 속성 페이지에서 구성 속성, 디버깅을 차례로 클릭합니다.
- 디버거에서 드롭다운 메뉴를 시작하려면 Windows용 디버깅 도구 - 원격 디버깅을 선택합니다.
대상 컴퓨터 구성 및 디버그 케이블 설정에 대한 자세한 내용은 Visual Studio에서 커널 모드 디버깅 설정 및 드라이버 배포 및 테스트를 위한 컴퓨터 프로비전(WDK 8.1)을 참조하세요.
참고 커널 디버거를 사용하여 UMDF 드라이버를 디버그할 수 있지만 사용자 모드(원격) 디버거가 더 편리합니다. UMDF 템플릿에서 UMDF 드라이버를 만들 경우 사용자 모드 디버거가 이미 기본적으로 선택되어 있습니다.