WDK를 사용하여 드라이버 빌드

WDK(Windows 드라이버 키트)를 사용하여 드라이버를 빌드합니다. WDK 8 및 WDK 8.1은 Microsoft Visual Studio와 완전히 통합되어 있습니다. Visual Studio 개발 환경을 사용하여 드라이버를 빌드하거나 MSBuild(Microsoft 빌드 엔진)를 사용하여 명령줄에서 직접 드라이버를 빌드할 수 있습니다. Windows 8.1, Windows 8, Windows 7 및 Windows Vista용 드라이버를 빌드하려면 Visual Studio와 MSBuild를 사용합니다. Windows XP용 드라이버를 빌드하려면 Windows 7 WDK 및 Windows 빌드 유틸리티(Build.exe)를 사용해야 합니다.

중요  MSBuild는 WDK의 이전 버전에서 사용되었던 Windows 빌드 유틸리티(Build.exe)를 대신합니다. 이제 WDK는 Visual Studio 프로젝트를 빌드하는 데 사용하는 것과 동일한 컴파일러 및 빌드 도구를 사용합니다. 이전 버전의 WDK를 사용하여 빌드한 드라이버 프로젝트를 Visual Studio 환경에서 작동하도록 변환해야 합니다. 명령줄에서 변환 유틸리티를 실행하거나, 기존 원본에서 새로운 Visual Studio 프로젝트를 만들어 기존 드라이버를 변환할 수 있습니다. 자세한 내용은 기존 원본 파일에서 드라이버 만들기WDK 및 Visual Studio 빌드 환경을 참조하세요.

이 섹션의 내용은 다음과 같습니다.

Visual Studio를 사용하여 드라이버 빌드

Visual Studio에서 프로젝트나 솔루션을 빌드하는 것과 동일한 방식으로 드라이버를 빌드합니다. Windows 드라이버 템플릿을 사용하여 새 드라이버 프로젝트를 만들 때 템플릿은 기본(활성) 프로젝트 구성과 기본(활성) 솔루션 빌드 구성을 정의합니다.

참고  WDK(Windows 드라이버 키트) 8으로 만든 프로젝트 및 솔루션을 Windows 8.1 및 Microsoft Visual Studio 2013용 WDK에서 작동하도록 업그레이드해야 합니다. 프로젝트 또는 솔루션을 열기 전에 ProjectUpgradeTool을 실행합니다. ProjectUpgradeTool은 WDK 8.1을 사용하여 빌드할 수 있도록 프로젝트 및 솔루션을 변환합니다.

빌드 구성 관리 및 편집에 대한 자세한 내용은 Building in Visual Studio를 참조하세요.

솔루션 빌드 구성 선택, 옵션 설정 및 드라이버 빌드

기본 솔루션 빌드 구성은 Win8 DebugWin32입니다. WDK의 이전 버전에서 이 빌드 구성은 x86 확인된 빌드 환경을 사용하여 드라이버를 빌드하는 것에 해당합니다.

Ff554644.wedge(ko-kr,VS.85).gif구성을 선택하고 드라이버를 빌드하려면

  1. Visual Studio에서 드라이버 프로젝트 또는 솔루션을 엽니다.
  2. 솔루션 탐색기에서 솔루션을 마우스 오른쪽 단추로 클릭하고 구성 관리자를 선택합니다.
  3. 구성 관리자에서 관심 있는 빌드 형식에 해당하는 활성 솔루션 구성(예: Win8 Debug 또는 Win8 Release) 및 활성 솔루션 플랫폼(예: Win32)을 선택합니다.
  4. 드라이버 또는 드라이버 패키지에 대한 프로젝트 속성을 구성합니다. 배포, 드라이버 서명 또는 기타 작업에 대한 속성을 설정할 수 있습니다. 자세한 내용은 드라이버 및 드라이버 패키지에 대한 프로젝트 속성 구성을 참조하세요.
  5. 빌드 메뉴에서 솔루션 빌드를 클릭합니다(Ctrl+Shift+B).

명령줄(MSBuild)을 사용하여 드라이버 빌드

Visual Studio 명령 프롬프트 창, Windows 빌드 유틸리티(Build.exe)를 사용했던 WDK의 Microsoft 빌드 엔진(MSBuild) 이전 버전, 지원되는 빌드 구성 각각에 대해 제공되는 별도의 빌드 환경 창을 사용하여 명령줄에서 드라이버를 빌드할 수 있습니다. 이제 모든 빌드 구성에 대해 Visual Studio 명령 프롬프트 창을 사용할 수 있습니다.

Ff554644.wedge(ko-kr,VS.85).gifVisual Studio 명령 프롬프트 창을 사용하여 드라이버를 빌드하려면

  1. Visual Studio 명령 프롬프트 창을 엽니다.

    이 창에서 프로젝트(.VcxProj) 또는 솔루션(.Sln) 파일을 지정하면 MSBuild.exe를 사용하여 Visual Studio 프로젝트를 빌드할 수 있습니다.

  2. 프로젝트 디렉터리로 이동하고 대상에 대한 MSbuild 명령을 입력합니다.

    예를 들어 기본 플랫폼 및 구성을 사용하여 MyDriver.vcxproj라는 Visual Studio 드라이버 프로젝트를 새로 빌드하려면 프로젝트 디렉터리로 이동하고 다음 MSBuild 명령을 입력합니다.

    msbuild /t:clean /t:build .\MyDriver.vcxproj 
    

    구문 - 특정 구성 및 플랫폼을 지정하려면 다음 명령 구문을 사용합니다.

    
    msbuild /t:clean /t:build ProjectFile /p:Configuration=configuration /p:Platform=platform     
    
    
    

    예를 들어, 다음 명령은 "Win8 Debug" 구성 및 "Win32" 플랫폼에 대한 드라이버를 빌드합니다.

    msbuild /t:clean /t:build .\MyDriver.vcxproj /p:Configuration="Win8 Debug" /p:Platform=Win32
    

Visual Studio에서의 WDK 프로젝트 빌드 구성

다음 표에서는 Visual Studio의 프로젝트 빌드 구성이 이전 버전의 WDK(WDK 8 이전)에서 사용했던 빌드 환경과 어떻게 대응되는지를 보여 줍니다.

중요  Windows XP용 드라이버 또는 ia64 기반 컴퓨터용 드라이버를 빌드하려면 Windows 7 WDK를 사용해야 합니다. Windows 7 WDK는 Windows 개발자 센터 - 하드웨어 사이트에서 다운로드할 수 있습니다. Windows Vista용 드라이버를 빌드하려면 WDK 8 또는 WDK 7을 사용해야 합니다.

프로젝트 구성프로젝트 플랫폼해당하는 Windows 7 WDK 빌드 환경 창

Win8.1 디버그

Win32, x64 또는 ARM

Windows 7 WDK 또는 WDK 8에서는 사용할 수 없습니다.

Win8.1 릴리스

Win32, x64 또는 ARM

Windows 7 WDK 또는 WDK 8에서는 사용할 수 없습니다.

Win8 디버그

Win32 또는 x64

Windows 7 WDK에서는 사용할 수 없음

Win8 릴리스

Win32 또는 x64

Windows 7 WDK에서는 사용할 수 없음

Win7 디버그

Win32

Win7 x86 확인된 빌드

Win7 릴리스

Win32

Win7 x86 릴리스 빌드

Win7 디버그

x64

Win7 x64 확인된 빌드

Win7 릴리스

x64

Win7 x64 릴리스 빌드

Vista 디버그

Not available in WDK 8.1

Win32

Vista x86 확인된 빌드

Vista 릴리스

Not available in WDK 8.1

Win32

Vista x86 릴리스 빌드

Vista 디버그

Not available in WDK 8.1.

x64

Vista x64 확인된 빌드

Vista 릴리스

Not available in WDK 8.1.

x64

Vista x64 릴리스 빌드

 

드라이버 및 드라이버 패키지에 대한 프로젝트 속성 구성

속성 페이지에서는 드라이버 및 드라이버 패키지에 대한 옵션을 구성하고 설정할 수 있습니다. 솔루션을 빌드할 때 드라이버가 자동으로 서명되거나 원격 테스트 컴퓨터에 자동으로 배포되도록 드라이버를 구성할 수 있습니다.

WDK는 빌드 프로세스에 일반적으로 포함되는 StampinfWPP 전처리기(WPP 추적) 같은 다양한 명령줄 도구를 제공합니다. 이러한 도구는 Visual Studio와 함께 배포되지 않으며, Visual Studio 빌드 환경과의 통합을 위해 MSBuild용 WDK 작업으로 래핑됩니다. 드라이버 템플릿 중 하나를 사용하거나 변환한 기존 드라이버가 있는 경우 이러한 속성 페이지가 프로젝트에 이미 존재합니다. 그렇지 않은 경우에는 관련 파일 형식(예: 메시지 컴파일러에 대한 .mc 또는 .man 파일)을 프로젝트 또는 솔루션에 추가하면 속성 페이지가 자동으로 프로젝트에 추가됩니다. 자세한 내용은 WDK 및 Visual Studio 빌드 환경을 참조하세요.

개별 드라이버 또는 전체 드라이버 패키지에 대해 속성을 설정할 수 있습니다. 다음 표에는 드라이버와 드라이버 패키지에 대해 특별히 구성할 수 있는 일부 속성이 나와 있습니다.

드라이버 프로젝트 속성드라이버 패키지 속성

개별 드라이버 파일에 대한 서명 속성(드라이버 서명 참조)

드라이버 패키지에 대한 서명 속성(드라이버 서명 참조)

드라이버 프로젝트에 대한 카운터 매니페스트 전처리기 속성(CTRPP용)

드라이버 패키지 프로젝트에 대한 배포 속성(테스트 컴퓨터에 드라이버 배포 참조)

드라이버 프로젝트에 대한 드라이버 모델 설정 속성

드라이버 패키지 프로젝트에 대한 드라이버 검증 도구 속성

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

드라이버 패키지 프로젝트에 대한 KMDF 검증 도구 속성

드라이버 프로젝트에 대한 Stampinf 속성

드라이버 패키지 프로젝트에 대한 UMDF 검증 도구 속성

WPP 전처리기(WPP 추적)

드라이버 패키지 프로젝트에 대한 Inf2Cat 속성(Inf2Cat 도구 참조)

 

드라이버 빌드 문제 해결 팁

다음은 WDK 및 Visual Studio를 사용하여 드라이버를 빌드할 때 문제 해결에 도움이 되는 팁입니다.

Ff554644.wedge(ko-kr,VS.85).gifVisual Studio의 옵션을 사용하여 빌드 출력의 자세한 정도를 향상시키려면

  1. Tools> Options을 클릭합니다.
  2. 프로젝트 및 솔루션 폴더를 클릭하고 빌드 및 실행을 클릭합니다.
  3. MSBuild 프로젝트 빌드 출력의 자세한 정도MSBuild 프로젝트 빌드 로그 파일의 자세한 정도에 대한 옵션을 변경합니다. 기본적으로 이러한 옵션은 최소로 설정되어 있습니다.

관련 항목

Building in Visual Studio
ProjectUpgradeTool
MSBuild
기존 원본 파일에서 드라이버 만들기
WDK 및 Visual Studio 빌드 환경
드라이버 서명
테스트 컴퓨터에 드라이버 배포

 

 

표시:
© 2014 Microsoft