본문으로 이동
주 메뉴
주 메뉴
사이드바로 이동
숨기기
둘러보기
대문
최근 바뀜
임의 문서로
~ldmsys
검색
검색
외관
로그인
개인 도구
로그인
현재 모든 문서는 작성 중입니다. 보시는 데 불편함이 있더라도 양해 부탁드립니다.
킥스타트 가이드/Windows 드라이버 시작하기 문서 원본 보기
문서
토론
한국어
읽기
원본 보기
역사 보기
도구
도구
사이드바로 이동
숨기기
작업
읽기
원본 보기
역사 보기
일반
여기를 가리키는 문서
가리키는 글의 최근 바뀜
문서 정보
외관
사이드바로 이동
숨기기
←
킥스타트 가이드/Windows 드라이버 시작하기
문서 편집 작업을 수행할 권한이 없습니다. 다음 이유를 확인해주세요:
요청한 작업은 다음 권한을 가진 사용자에게 제한됩니다:
사용자
.
문서의 원본을 보거나 복사할 수 있습니다.
[[킥스타트 가이드]]로 돌아가기 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를 사용한다면 [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]에서 ‘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 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> #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; } </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> == 빌드 == # 프로젝트 속성의 ‘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> sc.exe create HelloDriver type= kernel start= demand binPath= "C:\Drivers\HelloDriver\HelloDriver.sys" sc.exe start HelloDriver sc.exe query HelloDriver </pre> <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> SERVICE_NAME: HelloDriver TYPE : 1 KERNEL_DRIVER STATE : 4 RUNNING </pre> 언로드한 뒤 등록을 제거한다. <pre> sc.exe stop HelloDriver sc.exe query HelloDriver sc.exe delete HelloDriver </pre> 중지 후 상태는 <code>1 STOPPED</code>다. 새 빌드를 시험할 때는 중지 → .sys 교체 → 시작 순서로 진행한다. == 오류 확인 == {| class="wikitable" ! 증상 !! 확인할 항목 |- | 액세스 거부 || 로더나 명령 프롬프트의 관리자 권한 |- | 파일을 찾을 수 없음 || 게스트의 .sys 경로와 <code>sc.exe qc HelloDriver</code>의 BINARY_PATH_NAME |- | 오류 193 || 게스트와 드라이버의 아키텍처가 모두 x64인지 확인 |- | 오류 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> bcdedit /set TESTSIGNING ON </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> bcdedit /set TESTSIGNING OFF </pre> 변경했던 메모리 무결성과 VM Secure Boot를 원래 상태로 되돌리고 필요한 재부팅을 마친다. 부팅에 문제가 있으면 실습 전 스냅샷으로 복원한다. == 참고 문헌 == <references />
킥스타트 가이드/Windows 드라이버 시작하기
문서로 돌아갑니다.
검색
검색
킥스타트 가이드/Windows 드라이버 시작하기 문서 원본 보기
새 주제