킥스타트 가이드/Windows 드라이버 시작하기: 두 판 사이의 차이
Windows 드라이버 킥스타트: WDK 설치, 최소 WDM 예제, VM 서명 설정, OSRLoader 및 sc.exe 로드·복구 |
전체 문장 정리: 반복 설명·반박형 문장·볼드 강조 제거, 실습 순서와 복구 절차 유지 |
||
| 1번째 줄: | 1번째 줄: | ||
[[킥스타트 가이드]]로 돌아가기 | [[킥스타트 가이드]]로 돌아가기 | ||
Windows | WDK로 간단한 커널 드라이버를 빌드하고 Windows 11 x64 VM에서 로드·언로드한다. 예제는 WDM(Windows Driver Model) 프로젝트로 만든 수동 시작 비PnP 드라이버다. | ||
빌드는 Windows 호스트나 VM에서 진행할 수 있다. 아래 부팅 설정과 로드 작업은 테스트 VM에서 수행한다. | |||
== WDK 설치 == | == WDK 설치 == | ||
2026년 11월 15일 | 2026년 11월 15일 Microsoft가 안내하는 조합은 Visual Studio 2026 + WDK 28000.2526이다. Visual Studio 2022를 사용한다면 [https://learn.microsoft.com/en-us/windows-hardware/drivers/other-wdk-downloads WDK 26100.6584]를 설치한다.<ref name="wdk">[https://learn.microsoft.com/en-us/windows-hardware/drivers/download-the-wdk Microsoft Learn, Download the Windows Driver Kit (WDK)]</ref> | ||
# [https://visualstudio.microsoft.com/ Visual Studio Installer]에서 | # [https://visualstudio.microsoft.com/ Visual Studio Installer]에서 ‘C++를 사용한 데스크톱 개발’ 워크로드를 선택한다. | ||
# | # ‘개별 구성 요소’에 Windows Driver Kit 확장과 해당 도구 집합의 Spectre 완화 라이브러리를 추가한다. C++·ATL·MFC의 x64/x86 및 ARM64/ARM64EC 구성 요소는 [https://learn.microsoft.com/en-us/windows-hardware/drivers/download-the-wdk WDK 설치 문서]의 목록을 따른다. | ||
# 같은 문서의 다운로드 링크로 Windows SDK, WDK 순서로 설치한다. SDK와 WDK는 빌드 번호가 일치해야 한다. 최신 조합은 28000 계열이다. | |||
# Visual Studio를 다시 | # Visual Studio를 다시 실행한다. | ||
Visual Studio | 새 프로젝트에서 드라이버 템플릿이 검색되지 않으면 Visual Studio Installer의 ‘수정 → 개별 구성 요소 → Windows Driver Kit’를 확인한다. | ||
== | == 프로젝트와 코드 == | ||
# ‘새 프로젝트 만들기 → Empty WDM Driver’를 선택하고 이름을 <code>HelloDriver</code>로 지정한다. | |||
# 구성을 Debug, 플랫폼을 x64로 선택한다. | |||
# | # 소스 파일 <code>Driver.c</code>를 추가하고 다음 코드를 작성한다.<ref name="wdm-project">[https://learn.microsoft.com/en-us/windows-hardware/drivers/develop/creating-a-new-driver Microsoft Learn, Creating a New Driver]</ref> | ||
# | |||
# 소스 | |||
<pre> | <pre> | ||
| 65번째 줄: | 47번째 줄: | ||
</pre> | </pre> | ||
로드 시 호출되는 <code>DriverEntry</code>에서 언로드 함수 <code>HelloUnload</code>를 등록한다. <code>STATUS_SUCCESS</code>는 초기화 성공을 나타낸다.<ref name="entry">[https://learn.microsoft.com/en-us/windows-hardware/drivers/ddi/wdm/nc-wdm-driver_initialize Microsoft Learn, DRIVER_INITIALIZE callback function]</ref> 두 함수의 <code>DbgPrintEx</code> 출력은 WinDbg 같은 커널 디버거에서 볼 수 있다.<ref name="dbgprint">[https://learn.microsoft.com/en-us/windows-hardware/drivers/ddi/wdm/nf-wdm-dbgprintex Microsoft Learn, DbgPrintEx function]</ref> | |||
<code>DbgPrintEx</code> | |||
== | == 빌드 == | ||
# 프로젝트 속성의 ‘Driver Signing → Sign Mode’를 Off로 설정한다.<ref name="sign-properties">[https://learn.microsoft.com/en-us/windows-hardware/drivers/develop/driver-signing-properties Microsoft Learn, Driver Signing Properties]</ref> | |||
# 프로젝트를 빌드하고 출력 창에서 <code>HelloDriver.sys</code>의 경로를 확인한다. 기본 출력 위치는 보통 <code>x64\Debug</code> 아래다. | |||
# 파일을 VM의 <code>C:\Drivers\HelloDriver\HelloDriver.sys</code>로 복사한다. 디버깅용 <code>HelloDriver.pdb</code>도 같은 빌드의 파일을 보관한다. | |||
이 예제는 서비스로 직접 등록하므로 INF 패키지가 필요 없다. 빈 프로젝트에 포함된 미완성 INF 때문에 패키징 오류가 나면 해당 INF를 프로젝트에서 제외하고 .sys 프로젝트를 빌드한다. | |||
== VM 부팅 설정 == | |||
서명하지 않은 .sys를 실행하기 위해 드라이버 서명 적용(Driver Signature Enforcement)을 한 부팅 세션 동안 해제한다. <code>verifier.exe</code>로 설정하는 Driver Verifier는 드라이버 동작을 검사하는 별도 도구다.<ref name="verifier">[https://learn.microsoft.com/en-us/windows-hardware/drivers/devtest/driver-verifier Microsoft Learn, Driver Verifier]</ref> | |||
=== 준비 === | |||
* 변경 전 VM 스냅샷을 만든다. | |||
* BitLocker나 장치 암호화를 사용한다면 복구 키를 준비한다. 부팅 설정 변경 후 요구될 수 있다. | |||
* 게스트의 ‘Windows 보안 → 장치 보안 → 코어 격리 세부 정보’에서 메모리 무결성(HVCI)이 켜져 있으면 기존 상태를 기록하고 끈 뒤 재부팅한다. HVCI는 미서명 커널 코드의 실행을 제한한다.<ref name="hvci">[https://learn.microsoft.com/en-us/windows/security/hardware-security/enable-virtualization-based-protection-of-code-integrity Microsoft Learn, Enable memory integrity]</ref> | |||
=== 서명 적용 해제 === | |||
# VM의 시작 메뉴에서 Shift 키를 누른 채 ‘다시 시작’을 선택한다. | |||
# ‘문제 해결 → 고급 옵션 → 시작 설정 → 다시 시작’으로 이동한다. | |||
# ‘7 또는 F7: 드라이버 서명 적용 사용 안 함’을 선택하고 로그인한다.<ref name="startup">[https://support.microsoft.com/en-au/windows/experience/startup-boot/windows-startup-settings Microsoft Support, Windows Startup Settings]</ref> | |||
= | 이 설정은 다음 재부팅까지 유효하다.<ref name="unsigned">[https://learn.microsoft.com/en-us/windows-hardware/drivers/install/installing-an-unsigned-driver-during-development-and-test Microsoft Learn, Installing an Unsigned Driver during Development and Test]</ref> Secure Boot가 설정 변경을 막는 경우에는 VM을 종료한 뒤 VM 펌웨어 설정에서 해제하고 원래 값을 기록한다. 조직 정책으로 변경이 제한된 환경에서는 별도 실습 VM을 사용한다. | ||
== OSR Driver Loader == | |||
OSR Driver Loader는 비PnP 드라이버를 서비스로 등록하고 시작·중지하는 도구다.<ref name="osr-nonpnp">[https://community.osr.com/t/osrloader-and-loading-of-filterdrivers/40002 OSR, OSRLoader and loading of FilterDrivers]</ref> OSR Online이 2026년 5월 콘텐츠 제공을 종료하면서 기존 공식 다운로드도 중단됐다.<ref name="osr-retired">[https://osronline.com/article.cfm/?article=157 OSR Online, Gone!], 2026-11-15 확인.</ref> 기존 배포본이 있다면 아래 절차를 따르고, 없다면 다음 절의 Windows 내장 <code>sc.exe</code>를 사용한다. | |||
# VM에서 OSR Driver Loader를 관리자 권한으로 실행한다. | |||
# 파일 경로를 <code>C:\Drivers\HelloDriver\HelloDriver.sys</code>로 지정한다. | |||
# 시작 유형을 Demand(수동 시작)로 선택한다. | |||
# Register Service로 등록하고 Start Service로 로드한다. | |||
# 다음 절의 <code>sc.exe query</code>로 상태를 확인한다. 서비스 이름이 다르면 <code>HelloDriver</code>를 실제 등록된 이름으로 바꾼다. | |||
# 종료할 때는 Stop Service, Unregister Service 순서로 실행한다. | |||
== | == sc.exe == | ||
관리자 권한 명령 프롬프트에서 다음을 실행한다. OSRLoader로 이미 등록했다면 첫 줄은 생략한다. | |||
<pre> | <pre> | ||
| 128번째 줄: | 96번째 줄: | ||
</pre> | </pre> | ||
<code>type= kernel</code>은 | <code>type= kernel</code>은 커널 드라이버, <code>start= demand</code>는 수동 시작을 지정한다. 옵션의 등호 뒤에는 공백이 필요하다.<ref name="sc-create">[https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/sc-create Microsoft Learn, sc.exe create]</ref> PowerShell에서도 <code>sc.exe</code>로 실행한다. | ||
조회 | 로드 성공 시 조회 결과는 다음 형태다. | ||
<pre> | <pre> | ||
| 138번째 줄: | 106번째 줄: | ||
</pre> | </pre> | ||
언로드한 뒤 등록을 제거한다. | |||
<pre> | <pre> | ||
| 146번째 줄: | 114번째 줄: | ||
</pre> | </pre> | ||
중지 | 중지 후 상태는 <code>1 STOPPED</code>다. 새 빌드를 시험할 때는 중지 → .sys 교체 → 시작 순서로 진행한다. | ||
== 오류 확인 == | == 오류 확인 == | ||
{| class="wikitable" | {| class="wikitable" | ||
! 증상 !! | ! 증상 !! 확인할 항목 | ||
|- | |- | ||
| | | 액세스 거부 || 로더나 명령 프롬프트의 관리자 권한 | ||
|- | |- | ||
| 파일을 찾을 수 없음 || . | | 파일을 찾을 수 없음 || 게스트의 .sys 경로와 <code>sc.exe qc HelloDriver</code>의 BINARY_PATH_NAME | ||
|- | |- | ||
| 193 | | 오류 193 || 게스트와 드라이버의 아키텍처가 모두 x64인지 확인 | ||
|- | |- | ||
| 577 | | 오류 577, 서명 확인 실패 || F7로 부팅했는지, 이후 재부팅했는지, HVCI 및 코드 무결성 정책 상태 | ||
|- | |- | ||
| 서비스가 이미 존재함 || | | 서비스가 이미 존재함 || <code>sc.exe qc HelloDriver</code>로 기존 등록 경로 확인 | ||
|- | |- | ||
| | | 시작 실패, 블루스크린 || 시스템 로그, CodeIntegrity/Operational 로그, 덤프의 오류 코드 | ||
|} | |} | ||
== 반복 개발용 테스트 서명 == | |||
== 반복 | |||
반복해서 로드할 때는 테스트 서명을 사용할 수 있다. 프로젝트의 ‘Driver Signing → Sign Mode’를 Test Sign으로 바꾸고 빌드한다. Test Certificate가 비어 있으면 Visual Studio가 프로젝트용 인증서를 생성한다.<ref name="sign-properties" /> | |||
필요한 테스트 인증서를 게스트에 배포한 뒤 관리자 명령 프롬프트에서 다음을 실행하고 재부팅한다. | |||
<pre> | <pre> | ||
| 179번째 줄: | 144번째 줄: | ||
</pre> | </pre> | ||
테스트 모드에서도 드라이버 이미지의 서명이 필요하다. HVCI를 사용하는 경우 코드도 HVCI와 호환돼야 한다. Secure Boot가 명령 실행을 막으면 VM 펌웨어에서 해제한다.<ref name="testsigning">[https://learn.microsoft.com/en-us/windows-hardware/drivers/install/the-testsigning-boot-configuration-option Microsoft Learn, The TESTSIGNING Boot Configuration Option]</ref> | |||
== 실습 | == 실습 종료 == | ||
드라이버를 중지하고 등록을 제거한 뒤 재부팅한다. F7로 해제한 서명 적용은 재부팅 시 복구된다. 테스트 모드를 켰다면 먼저 다음을 실행한다. | |||
<pre> | <pre> | ||
| 193번째 줄: | 154번째 줄: | ||
</pre> | </pre> | ||
변경했던 메모리 무결성과 VM Secure Boot를 원래 상태로 되돌리고 필요한 재부팅을 마친다. 부팅에 문제가 있으면 실습 전 스냅샷으로 복원한다. | |||
== 참고 문헌 == | == 참고 문헌 == | ||
<references /> | <references /> | ||
2026년 11월 16일 (월) 08:53 기준 최신판
킥스타트 가이드로 돌아가기
WDK로 간단한 커널 드라이버를 빌드하고 Windows 11 x64 VM에서 로드·언로드한다. 예제는 WDM(Windows Driver Model) 프로젝트로 만든 수동 시작 비PnP 드라이버다.
빌드는 Windows 호스트나 VM에서 진행할 수 있다. 아래 부팅 설정과 로드 작업은 테스트 VM에서 수행한다.
WDK 설치
2026년 11월 15일 Microsoft가 안내하는 조합은 Visual Studio 2026 + WDK 28000.2526이다. Visual Studio 2022를 사용한다면 WDK 26100.6584를 설치한다.[1]
- Visual Studio Installer에서 ‘C++를 사용한 데스크톱 개발’ 워크로드를 선택한다.
- ‘개별 구성 요소’에 Windows Driver Kit 확장과 해당 도구 집합의 Spectre 완화 라이브러리를 추가한다. C++·ATL·MFC의 x64/x86 및 ARM64/ARM64EC 구성 요소는 WDK 설치 문서의 목록을 따른다.
- 같은 문서의 다운로드 링크로 Windows SDK, WDK 순서로 설치한다. SDK와 WDK는 빌드 번호가 일치해야 한다. 최신 조합은 28000 계열이다.
- Visual Studio를 다시 실행한다.
새 프로젝트에서 드라이버 템플릿이 검색되지 않으면 Visual Studio Installer의 ‘수정 → 개별 구성 요소 → Windows Driver Kit’를 확인한다.
프로젝트와 코드
- ‘새 프로젝트 만들기 → Empty WDM Driver’를 선택하고 이름을
HelloDriver로 지정한다. - 구성을 Debug, 플랫폼을 x64로 선택한다.
- 소스 파일
Driver.c를 추가하고 다음 코드를 작성한다.[2]
#include <ntddk.h>
DRIVER_INITIALIZE DriverEntry;
DRIVER_UNLOAD HelloUnload;
VOID HelloUnload(PDRIVER_OBJECT DriverObject)
{
UNREFERENCED_PARAMETER(DriverObject);
DbgPrintEx(DPFLTR_IHVDRIVER_ID, DPFLTR_INFO_LEVEL,
"HelloDriver: unloaded\n");
}
NTSTATUS DriverEntry(PDRIVER_OBJECT DriverObject,
PUNICODE_STRING RegistryPath)
{
UNREFERENCED_PARAMETER(RegistryPath);
DriverObject->DriverUnload = HelloUnload;
DbgPrintEx(DPFLTR_IHVDRIVER_ID, DPFLTR_INFO_LEVEL,
"HelloDriver: loaded\n");
return STATUS_SUCCESS;
}
로드 시 호출되는 DriverEntry에서 언로드 함수 HelloUnload를 등록한다. STATUS_SUCCESS는 초기화 성공을 나타낸다.[3] 두 함수의 DbgPrintEx 출력은 WinDbg 같은 커널 디버거에서 볼 수 있다.[4]
빌드
- 프로젝트 속성의 ‘Driver Signing → Sign Mode’를 Off로 설정한다.[5]
- 프로젝트를 빌드하고 출력 창에서
HelloDriver.sys의 경로를 확인한다. 기본 출력 위치는 보통x64\Debug아래다. - 파일을 VM의
C:\Drivers\HelloDriver\HelloDriver.sys로 복사한다. 디버깅용HelloDriver.pdb도 같은 빌드의 파일을 보관한다.
이 예제는 서비스로 직접 등록하므로 INF 패키지가 필요 없다. 빈 프로젝트에 포함된 미완성 INF 때문에 패키징 오류가 나면 해당 INF를 프로젝트에서 제외하고 .sys 프로젝트를 빌드한다.
VM 부팅 설정
서명하지 않은 .sys를 실행하기 위해 드라이버 서명 적용(Driver Signature Enforcement)을 한 부팅 세션 동안 해제한다. verifier.exe로 설정하는 Driver Verifier는 드라이버 동작을 검사하는 별도 도구다.[6]
준비
- 변경 전 VM 스냅샷을 만든다.
- BitLocker나 장치 암호화를 사용한다면 복구 키를 준비한다. 부팅 설정 변경 후 요구될 수 있다.
- 게스트의 ‘Windows 보안 → 장치 보안 → 코어 격리 세부 정보’에서 메모리 무결성(HVCI)이 켜져 있으면 기존 상태를 기록하고 끈 뒤 재부팅한다. HVCI는 미서명 커널 코드의 실행을 제한한다.[7]
서명 적용 해제
- VM의 시작 메뉴에서 Shift 키를 누른 채 ‘다시 시작’을 선택한다.
- ‘문제 해결 → 고급 옵션 → 시작 설정 → 다시 시작’으로 이동한다.
- ‘7 또는 F7: 드라이버 서명 적용 사용 안 함’을 선택하고 로그인한다.[8]
이 설정은 다음 재부팅까지 유효하다.[9] Secure Boot가 설정 변경을 막는 경우에는 VM을 종료한 뒤 VM 펌웨어 설정에서 해제하고 원래 값을 기록한다. 조직 정책으로 변경이 제한된 환경에서는 별도 실습 VM을 사용한다.
OSR Driver Loader
OSR Driver Loader는 비PnP 드라이버를 서비스로 등록하고 시작·중지하는 도구다.[10] OSR Online이 2026년 5월 콘텐츠 제공을 종료하면서 기존 공식 다운로드도 중단됐다.[11] 기존 배포본이 있다면 아래 절차를 따르고, 없다면 다음 절의 Windows 내장 sc.exe를 사용한다.
- VM에서 OSR Driver Loader를 관리자 권한으로 실행한다.
- 파일 경로를
C:\Drivers\HelloDriver\HelloDriver.sys로 지정한다. - 시작 유형을 Demand(수동 시작)로 선택한다.
- Register Service로 등록하고 Start Service로 로드한다.
- 다음 절의
sc.exe query로 상태를 확인한다. 서비스 이름이 다르면HelloDriver를 실제 등록된 이름으로 바꾼다. - 종료할 때는 Stop Service, Unregister Service 순서로 실행한다.
sc.exe
관리자 권한 명령 프롬프트에서 다음을 실행한다. OSRLoader로 이미 등록했다면 첫 줄은 생략한다.
sc.exe create HelloDriver type= kernel start= demand binPath= "C:\Drivers\HelloDriver\HelloDriver.sys" sc.exe start HelloDriver sc.exe query HelloDriver
type= kernel은 커널 드라이버, start= demand는 수동 시작을 지정한다. 옵션의 등호 뒤에는 공백이 필요하다.[12] PowerShell에서도 sc.exe로 실행한다.
로드 성공 시 조회 결과는 다음 형태다.
SERVICE_NAME: HelloDriver
TYPE : 1 KERNEL_DRIVER
STATE : 4 RUNNING
언로드한 뒤 등록을 제거한다.
sc.exe stop HelloDriver sc.exe query HelloDriver sc.exe delete HelloDriver
중지 후 상태는 1 STOPPED다. 새 빌드를 시험할 때는 중지 → .sys 교체 → 시작 순서로 진행한다.
오류 확인
| 증상 | 확인할 항목 |
|---|---|
| 액세스 거부 | 로더나 명령 프롬프트의 관리자 권한 |
| 파일을 찾을 수 없음 | 게스트의 .sys 경로와 sc.exe qc HelloDriver의 BINARY_PATH_NAME
|
| 오류 193 | 게스트와 드라이버의 아키텍처가 모두 x64인지 확인 |
| 오류 577, 서명 확인 실패 | F7로 부팅했는지, 이후 재부팅했는지, HVCI 및 코드 무결성 정책 상태 |
| 서비스가 이미 존재함 | sc.exe qc HelloDriver로 기존 등록 경로 확인
|
| 시작 실패, 블루스크린 | 시스템 로그, CodeIntegrity/Operational 로그, 덤프의 오류 코드 |
반복 개발용 테스트 서명
반복해서 로드할 때는 테스트 서명을 사용할 수 있다. 프로젝트의 ‘Driver Signing → Sign Mode’를 Test Sign으로 바꾸고 빌드한다. Test Certificate가 비어 있으면 Visual Studio가 프로젝트용 인증서를 생성한다.[5]
필요한 테스트 인증서를 게스트에 배포한 뒤 관리자 명령 프롬프트에서 다음을 실행하고 재부팅한다.
bcdedit /set TESTSIGNING ON
테스트 모드에서도 드라이버 이미지의 서명이 필요하다. HVCI를 사용하는 경우 코드도 HVCI와 호환돼야 한다. Secure Boot가 명령 실행을 막으면 VM 펌웨어에서 해제한다.[13]
실습 종료
드라이버를 중지하고 등록을 제거한 뒤 재부팅한다. F7로 해제한 서명 적용은 재부팅 시 복구된다. 테스트 모드를 켰다면 먼저 다음을 실행한다.
bcdedit /set TESTSIGNING OFF
변경했던 메모리 무결성과 VM Secure Boot를 원래 상태로 되돌리고 필요한 재부팅을 마친다. 부팅에 문제가 있으면 실습 전 스냅샷으로 복원한다.
참고 문헌
- ↑ Microsoft Learn, Download the Windows Driver Kit (WDK)
- ↑ Microsoft Learn, Creating a New Driver
- ↑ Microsoft Learn, DRIVER_INITIALIZE callback function
- ↑ Microsoft Learn, DbgPrintEx function
- ↑ 5.0 5.1 Microsoft Learn, Driver Signing Properties
- ↑ Microsoft Learn, Driver Verifier
- ↑ Microsoft Learn, Enable memory integrity
- ↑ Microsoft Support, Windows Startup Settings
- ↑ Microsoft Learn, Installing an Unsigned Driver during Development and Test
- ↑ OSR, OSRLoader and loading of FilterDrivers
- ↑ OSR Online, Gone!, 2026-11-15 확인.
- ↑ Microsoft Learn, sc.exe create
- ↑ Microsoft Learn, The TESTSIGNING Boot Configuration Option