다음을 통해 공유

바코드 스캐너 드라이버 샘플

  • 아티클

바코드 스캐너 드라이버 샘플은 바코드 스캐너용 유니버설 드라이버를 만드는 방법을 보여 줍니다. 새 바코드 스캐너 드라이버를 만들기 위한 템플릿으로 사용됩니다. 이 샘플에서는 UMDF(사용자 모드 드라이버 프레임워크) 2.0을 사용하며 전용 액세스를 위해 디바이스를 클레임하는 것과 같은 기본 기능을 보여 줍니다. 샘플 드라이버는 x86, amd64 및 Arm 플랫폼에서 컴파일 및 배포할 수 있습니다. 유니버설 드라이버에 대한 자세한 내용은 유니버설 INF 파일 사용으로 이동하세요.

요구 사항

Windows SDK(소프트웨어 개발 키트) 10도 필요하지만 Microsoft Visual Studio의 일부로 설치됩니다.

샘플 드라이버는 소프트웨어 디바이스에서 작동하기 때문에 바코드 스캐너 하드웨어가 작동하지 않아도 됩니다. 샘플과 함께 사용하려는 하드웨어 디바이스가 있는 경우 INF 파일에 디바이스 하드웨어 ID를 추가하여 드라이버를 계속 사용할 수 있습니다.

샘플 다운로드 및 추출

Windows 드라이버 샘플은 GitHub에서 사용할 수 있습니다.

  1. Windows-driver-samples-master.zip 다운로드합니다. 이 파일에는 모든 WDK(Windows 드라이버 키트) 샘플이 포함되어 있습니다.

  2. 개발 머신에서 선택한 위치에 Windows-driver-samples-master.zip 추출합니다. 이 위치는 이 문서의 나머지 부분에서 참조 <sample_root> 됩니다.

Visual Studio에서 드라이버 솔루션 열기

  1. Windows 탐색기에서 폴더로 <sample_root>\pos\drivers\barcodescanner 이동합니다.

  2. 솔루션 파일을 두 번 클릭하고 BarcodeScanner.sln Visual Studio에서 솔루션을 엽니다.

  3. 솔루션을 열 때 보안 경고가 표시될 수 있도록 프로젝트 zip 파일이 인터넷에서 다운로드되었습니다. 이 경우 확인을 선택하여 프로젝트 로드를 완료합니다.

  4. Visual Studio에서 솔루션 탐색기 찾습니다. 아직 열려 있지 않으면 보기 메뉴에서 솔루션 탐색기 선택합니다. 솔루션 탐색기 포함된 프로젝트와 원본 파일을 볼 수 있습니다.

Visual Studio를 사용하여 샘플 빌드

  1. Visual Studio의 표준 도구 모음에서 운영 체제 플랫폼과 일치하는 솔루션 플랫폼을 선택합니다. 예를 들어 64비트 버전의 Windows를 사용하는 경우 x64를 선택합니다. Arm 플랫폼을 대상으로 하는 경우 구성 관리자를 사용하여 대상 목록에 Arm을 추가해야 합니다.

  2. 빌드 메뉴에서 솔루션 빌드를 선택합니다.

드라이버 설치

  1. 빌드할 때 드라이버는 테스트 인증으로 서명되었습니다. 테스트를 위해 드라이버를 설치하려면 테스트 인증서로 서명된 드라이버가 로드되도록 부팅 구성을 변경해야 합니다. 설정을 변경하려면 관리자 권한 명령 프롬프트를 열고 다음 명령을 입력합니다.

    bcdedit.exe /set TESTSIGNING on

  2. 컴퓨터를 다시 부팅합니다. 이전에 테스트 서명을 사용하도록 설정한 경우 다시 부팅할 필요가 없습니다.

  3. 관리자 권한 명령 프롬프트에서 프로젝트가 빌드된 폴더로 이동합니다. x64 디버그 빌드를 만든 경우 이 폴더는 다음과 같습니다 <project_root>\x64\Debug\SampleBarcodeScannerDrv.

    해당 폴더에 다음 파일이 표시됩니다.

    파일 설명
    SampleBarcodeScannerDrv.dll 드라이버 파일입니다.
    SampleBarcodeScannerDrv.inf 드라이버를 설치하는 데 필요한 정보가 포함된 INF 파일입니다.
    samplebarcodescannerdrv.cat 전체 패키지의 서명 역할을 하는 서명된 카탈로그 파일입니다.

  4. OS 및 드라이버 플랫폼과 일치하는 디바이스 콘솔 유틸리티(devcon.exe)의 경로를 식별합니다. x64 버전의 기본 위치는 .입니다 C:\Program Files (x86)\Windows Kits\10\Tools\x64.

  5. 다음 명령을 입력하고 이전 단계에서 찾은 devcon.exe 파일의 경로로 바꿉 <devcon\_path> 다.

    <devcon_path>\devcon.exe install SampleBarcodeScannerDrv.inf Root\SampleBarcodeScannerDrv

  6. 드라이버 게시자를 확인할 수 없다는 Windows 보안 대화 상자가 표시됩니다. 드라이버가 테스트 인증서로 서명되었기 때문입니다. 이 드라이버 소프트웨어 설치를 선택합니다. 잠시 후 드라이버가 올바르게 설치되었다는 확인 메시지가 표시됩니다.

디바이스 콘솔 유틸리티에서 드라이버를 설치할 수 없는 경우 현재 OS 플랫폼 및 드라이버 플랫폼과 일치하는 드라이버를 사용하고 있는지 확인합니다.

장치 관리자 디바이스 보기

  1. 디바이스 관리자를 엽니다. 이 작업은 여러 가지 방법으로 수행할 수 있지만 명령 프롬프트에 있는 경우 다음을 입력합니다 devmgmt.

  2. 장치 관리자 보기 메뉴에서 유형별로 디바이스를 선택합니다.

  3. 디바이스가 샘플 노드 아래에 나열됩니다.