WDK를 사용하여 드라이버 빌드
이 항목에서는 WDK(Windows 드라이버 키트)를 사용하여 드라이버를 빌드하는 방법을 설명합니다. WDK 10은 Microsoft Visual Studio와 완전히 통합되어 있습니다. Visual Studio 개발 환경을 사용하여 드라이버를 빌드하거나 MSBuild(Microsoft Build Engine)를 사용하여 명령줄에서 직접 드라이버를 빌드할 수 있습니다.
Microsoft Visual Studio Community 2015를 비롯한 모든 Microsoft Visual Studio 2015 버전을 사용하여 다음을 위한 드라이버를 빌드할 수 있습니다.
- Windows 10
- Windows 8.1
- Windows 7
중요 WDK(Windows 드라이버 키트) 8부터 이전 버전의 WDK에서 사용되던 Windows 빌드 유틸리티(Build.exe)가 MSBuild로 바뀌었습니다. 이제 WDK는 Visual Studio 프로젝트를 빌드하는 데 사용하는 것과 동일한 컴파일러 및 빌드 도구를 사용합니다. 이전 버전의 WDK를 사용하여 빌드한 드라이버 프로젝트를 Visual Studio 환경에서 작동하도록 변환해야 합니다. 명령줄에서 변환 유틸리티를 실행하거나, 기존 원본에서 새로운 Visual Studio 프로젝트를 만들어 기존 드라이버를 변환할 수 있습니다. 자세한 내용은 기존 원본 파일에서 드라이버 만들기 및 WDK 및 Visual Studio 빌드 환경을 참조하세요.
Visual Studio를 사용하여 드라이버 빌드
Visual Studio에서 프로젝트나 솔루션을 빌드하는 것과 동일한 방식으로 드라이버를 빌드합니다. Windows 드라이버 템플릿을 사용하여 새 드라이버 프로젝트를 만들 때 템플릿은 기본(활성) 프로젝트 구성과 기본(활성) 솔루션 빌드 구성을 정의합니다.
참고 WDK 8 또는 WDK(Windows 드라이버 키트) 8.1을 사용하여 만든 프로젝트 및 솔루션을 WDK(Windows 드라이버 키트) 10 및 Visual Studio 2015와 작동하도록 변환할 수 있습니다. 프로젝트 또는 솔루션을 열기 전에 ProjectUpgradeTool을 실행합니다. ProjectUpgradeTool은 WDK 10을 사용하여 빌드할 수 있도록 프로젝트 및 솔루션을 변환합니다.
빌드 구성 관리 및 편집에 대한 자세한 내용은 Building in Visual Studio를 참조하세요.
기본 솔루션 빌드 구성은 Debug 및 Win32입니다. Windows 8 이전의 WDK 버전에서 이 빌드 구성은 x86 확인된 빌드 환경을 사용하여 드라이버를 빌드하는 것에 해당합니다.
.gif "Ff554644.wedge(ko-kr,VS.85).gif")
구성을 선택하고 드라이버를 빌드하려면
- 동일한 버전의 SDK 및 WDK가 컴퓨터에 설치되어있는지 확인합니다.
- Visual Studio에서 드라이버 프로젝트 또는 솔루션을 엽니다.
- 솔루션 탐색기에서 솔루션을 마우스 오른쪽 단추로 클릭하고 구성 관리자를 선택합니다.
- 구성 관리자에서 관심 있는 빌드 형식에 해당하는 활성 솔루션 구성(예: Debug 또는 Release) 및 활성 솔루션 플랫폼(예: Win32)을 선택합니다.
- 드라이버를 빌드하려는 대상 운영 체제를 선택합니다. 드라이버 > 일반에서 프로젝트 속성으로 이동하고 TargetVersion 속성을 설정합니다.
- 드라이버 또는 드라이버 패키지에 대한 프로젝트 속성을 구성합니다. 배포, 드라이버 서명 또는 기타 작업에 대한 속성을 설정할 수 있습니다. 자세한 내용은 드라이버 및 드라이버 패키지에 대한 프로젝트 속성 구성을 참조하세요.
- 빌드 메뉴에서 솔루션 빌드를 클릭합니다(Ctrl+Shift+B).
명령줄(MSBuild)을 사용하여 드라이버 빌드
Visual Studio 명령 프롬프트 창과 Microsoft Build Engine(MSBuild)을 사용하여 명령줄에서 드라이버를 빌드할 수 있습니다.
Visual Studio 명령 프롬프트 창을 사용하여 드라이버를 빌드하려면
VS2015용 개발자 명령 프롬프트 창을 엽니다.
이 창에서 프로젝트(.VcxProj) 또는 솔루션(.Sln) 파일을 지정하면 MSBuild.exe를 사용하여 Visual Studio 프로젝트를 빌드할 수 있습니다.
프로젝트 디렉터리로 이동하고 대상에 대한 MSbuild 명령을 입력합니다.
예를 들어 기본 플랫폼 및 구성을 사용하여 MyDriver.vcxproj라는 Visual Studio 드라이버 프로젝트를 새로 빌드하려면 프로젝트 디렉터리로 이동하고 다음 MSBuild 명령을 입력합니다.
msbuild /t:clean /t:build .\MyDriver.vcxproj구문 - 특정 구성 및 플랫폼을 지정하려면 다음 명령 구문을 사용합니다.
msbuild /t:clean /t:build ProjectFile/p:Configuration=<Debug|Release>/p:Platform=architecture/p:TargetPlatformVersion=a.b.c.d/p:TargetVersion=OS예를 들어 다음 명령은 "Debug" 구성, "Win32" 플랫폼 및 Windows 10용 유니버설 Windows 드라이버를 빌드합니다.
msbuild /t:clean /t:build .\MyDriver.vcxproj /p:Configuration="Debug" /p:Platform=Win32 /p:TargetVersion=”Windows10” /p:TargetPlatformVersion=”10.0.10010.0”TargetPlatformVersion 설정은 옵션이며 이 옵션을 통해 빌드하는 데 사용할 키트 버전을 지정할 수 있습니다. 기본값은 최신 키트를 사용하는 것입니다.
드라이버 및 드라이버 패키지에 대한 프로젝트 속성 구성
속성 페이지에서는 드라이버 및 드라이버 패키지에 대한 옵션을 구성하고 설정할 수 있습니다. 솔루션을 빌드할 때 드라이버가 자동으로 서명되거나 원격 테스트 컴퓨터에 자동으로 배포되도록 드라이버를 구성할 수 있습니다.
WDK는 빌드 프로세스에 일반적으로 포함되는 Stampinf 및 WPP 전처리기(WPP 추적) 같은 다양한 명령줄 도구를 제공합니다. 이러한 도구는 Visual Studio와 함께 배포되지 않으며, Visual Studio 빌드 환경과의 통합을 위해 MSBuild용 WDK 작업으로 래핑됩니다. 드라이버 템플릿 중 하나를 사용하거나 변환한 기존 드라이버가 있는 경우 이러한 속성 페이지가 프로젝트에 이미 존재합니다. 그렇지 않은 경우에는 관련 파일 형식(예: 메시지 컴파일러에 대한 .mc 또는 .man 파일)을 프로젝트 또는 솔루션에 추가하면 속성 페이지가 자동으로 프로젝트에 추가됩니다. 자세한 내용은 WDK 및 Visual Studio 빌드 환경을 참조하세요.
개별 드라이버 또는 전체 드라이버 패키지에 대해 속성을 설정할 수 있습니다. 다음 표에는 드라이버와 드라이버 패키지에 대해 특별히 구성할 수 있는 일부 속성이 나와 있습니다.
| 드라이버 프로젝트 속성 | 드라이버 패키지 속성 |
|---|---|
개별 드라이버 파일에 대한 속성 서명(드라이버 서명 참조) |
드라이버 패키지에 대한 속성 서명(드라이버 서명 참조) |
| 드라이버 프로젝트에 대한 카운터 매니페스트 전처리기 속성(CTRPP용) | |
| 드라이버 프로젝트에 대한 드라이버 모델 설정 속성 | |
| 드라이버 프로젝트에 대한 메시지 컴파일러 속성 | |
| 드라이버 프로젝트에 대한 Stampinf 속성 | |
| WPP 전처리기(WPP 추적) |
드라이버 빌드 문제 해결 팁
다음은 WDK 및 Visual Studio를 사용하여 드라이버를 빌드할 때 문제 해결에 도움이 되는 팁입니다.
Visual Studio의 옵션을 사용하여 빌드 출력의 자세한 정도를 향상시키려면
- Tools> Options을 클릭합니다.
- 프로젝트 및 솔루션 폴더를 클릭하고 빌드 및 실행을 클릭합니다.
- MSBuild 프로젝트 빌드 출력의 자세한 정도 및 MSBuild 프로젝트 빌드 로그 파일의 자세한 정도에 대한 옵션을 변경합니다. 기본적으로 이러한 옵션은 최소로 설정되어 있습니다.