킥스타트 가이드/Windows 드라이버 시작하기

관리자 (토론 | 기여)님의 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]

  1. Visual Studio Installer에서 ‘C++를 사용한 데스크톱 개발’ 워크로드를 선택한다.
  2. ‘개별 구성 요소’에 Windows Driver Kit 확장과 해당 도구 집합의 Spectre 완화 라이브러리를 추가한다. C++·ATL·MFC의 x64/x86 및 ARM64/ARM64EC 구성 요소는 WDK 설치 문서의 목록을 따른다.
  3. 같은 문서의 다운로드 링크로 Windows SDK, WDK 순서로 설치한다. SDK와 WDK는 빌드 번호가 일치해야 한다. 최신 조합은 28000 계열이다.
  4. Visual Studio를 다시 실행한다.

새 프로젝트에서 드라이버 템플릿이 검색되지 않으면 Visual Studio Installer의 ‘수정 → 개별 구성 요소 → Windows Driver Kit’를 확인한다.

프로젝트와 코드

  1. ‘새 프로젝트 만들기 → Empty WDM Driver’를 선택하고 이름을 HelloDriver로 지정한다.
  2. 구성을 Debug, 플랫폼을 x64로 선택한다.
  3. 소스 파일 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]

빌드

  1. 프로젝트 속성의 ‘Driver Signing → Sign Mode’를 Off로 설정한다.[5]
  2. 프로젝트를 빌드하고 출력 창에서 HelloDriver.sys의 경로를 확인한다. 기본 출력 위치는 보통 x64\Debug 아래다.
  3. 파일을 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]

서명 적용 해제

  1. VM의 시작 메뉴에서 Shift 키를 누른 채 ‘다시 시작’을 선택한다.
  2. ‘문제 해결 → 고급 옵션 → 시작 설정 → 다시 시작’으로 이동한다.
  3. ‘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를 사용한다.

  1. VM에서 OSR Driver Loader를 관리자 권한으로 실행한다.
  2. 파일 경로를 C:\Drivers\HelloDriver\HelloDriver.sys로 지정한다.
  3. 시작 유형을 Demand(수동 시작)로 선택한다.
  4. Register Service로 등록하고 Start Service로 로드한다.
  5. 다음 절의 sc.exe query로 상태를 확인한다. 서비스 이름이 다르면 HelloDriver를 실제 등록된 이름으로 바꾼다.
  6. 종료할 때는 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를 원래 상태로 되돌리고 필요한 재부팅을 마친다. 부팅에 문제가 있으면 실습 전 스냅샷으로 복원한다.

참고 문헌