기본 v4 프린터 드라이버 빌드

아티클
12/19/2024

Important

최신 인쇄 플랫폼은 Windows에서 프린터와 통신하는 데 선호되는 수단입니다. 프린터 장치 개발을 위해 Windows 10 및 11의 인쇄 환경을 사용자 지정하려면 MICROSOFT의 IPP 받은 편지함 클래스 드라이버와 PSA(인쇄 지원 앱)를 사용하는 것이 좋습니다.

자세한 내용은 최신 인쇄 플랫폼 및 인쇄 지원 앱 디자인 가이드를 참조하세요.

Important

Microsoft는 레거시 v3 및 v4 프린터 드라이버에 대한 수명 종료 서비스를 발표했습니다.

자세한 내용은 Windows의 타사 프린터 드라이버에 대한 서비스 종료 계획을 참조 하세요.

Warning

이 프린터 드라이버 자습서에는 여러 오류가 포함되어 있으며 현재 사용할 수 없습니다.

Microsoft Visual Studio 2019의 드라이버 개발 마법사를 사용하여 기본 v4 프린터 드라이버를 빌드하여 기능 프린터 드라이버를 만들 기능의 최소 집합을 선택합니다.

이 항목의 지침은 드라이버를 빌드하는 데 필요한 단계에 중점을 두고 마법사에서 사용할 수 있는 많은 프린터 드라이버 옵션을 설명하지 않습니다.

이 항목의 목적은 Visual Studio 2019에서 프린터 드라이버를 개발할 때 관련된 프로세스를 소개하는 것입니다.

프린터 드라이버 옵션에 대한 자세한 내용은 마법사의 드라이버 옵션 탐색에 나와 있습니다.

필수 조건

WDK(Windows 드라이버 키트) 다운로드의 지침에 따라 다음 항목을 완료해야 합니다.

C++ 워크로드 및 올바른 버전의 Windows 10 SDK를 사용하여 데스크톱 개발로 Visual Studio 2019를 설치합니다.
Windows 10 버전 2004용 WDK(Windows 드라이버 키트)를 설치합니다.
Visual Studio 2019용 WDK(Windows 드라이버 키트) 확장을 설치합니다.

기본 드라이버에 대한 기능 선택

Visual Studio의 주 메뉴에서 새>프로젝트 파일을>선택합니다.
새 프로젝트 창의 오른쪽 위 검색 상자에 프린터 드라이버 v4를 입력하고 Enter 키를 누릅니다. 그러면 이름에 검색 텍스트가 포함된 모든 드라이버 템플릿이 검색됩니다.
가운데 창에서 프린터 드라이버 V4를 선택합니다.
이름 필드에 드라이버의 이름을 입력한 다음 확인을 선택합니다. 예를 들어 MyV4PrintDriver를 입력 할 수 있습니다.
v4 인쇄 드라이버 만들기 마법사의 드라이버 렌더링 유형 선택:에서 사용자 지정 렌더링 필터가 있는 V4 인쇄 드라이버를 선택합니다(XPS만 허용).
다른 모든 옵션은 기본 설정에 두고 다음을 선택합니다.
마법사의 설정 정보 섹션에서 모든 옵션을 기본 설정에 두고 다음을 선택합니다.
마법사의 설정 정보(2페이지) 섹션에서 모든 옵션을 기본 설정에 두고 다음을 선택합니다.

Microsoft Visual Studio는 이전 선택 항목을 사용하여 MyV4PrintDriver에 대한 프로젝트 파일을 생성합니다.

생성된 드라이버 파일 확인

생성된 드라이버 파일의 폴더로 이동합니다. 예를 들어 프로젝트 MyV4PrintDriver의 이름을 지정한 경우 기본적으로 파일은 내 문서 > Visual Studio 2019 > Projects > MyV4PrintDriver MyV4PrintDriver >위치에 저장됩니다.

폴더에 다음 파일이 포함되어 있는지 확인합니다.

파일 이름	파일 형식
MyV4PrintDriver.gpd	프린터 설명 파일
MyV4PrintDriver.inf	설정 정보 파일
MyV4PrintDriver.vcxproj	C++ 프로젝트 파일
MyV4PrintDriver.vcxproj.filters	C++ Project 필터 파일
MyV4PrintDriver-manifest.ini	구성 설정 파일(인쇄 드라이버 매니페스트)
V4PrintDriver-Intellisense.js	Intellisense용 JavaScript 파일
V4PrintDriver-Intellisense-Windows8.1.js	Intellisense용 JavaScript 파일

앞의 표에서 만들어진 파일 중 하나가 INF 파일임을 확인합니다. Visual Studio는 드라이버를 설치하는 데 사용할 수 있도록 완료해야 하는 골격 INF 파일을 만들었습니다.

드라이버에 대한 고유한 PrinterDriverID 만들기

Visual Studio 도구 메뉴에서 GUID 만들기를 선택합니다.
옵션 4를 선택합니다. 레지스트리 형식을 지정하고 복사 단추를 선택합니다.
Visual Studio의 솔루션 탐색기 MyV4PrintDriver 노드를 확장합니다.
드라이버 파일을 선택한 다음 속성 창에서 고유 식별자 필드의 값을 확인합니다. 이 값을 붙여넣기를 사용하여 생성한 GUID로 바꿉다.

INF 파일 완료

MyV4PrintDriver 프로젝트에는 드라이버 파일에 대한 항목이 있어야 합니다. 이 파일을 열고 MyV4PrintDriver.inf 파일이 나열되어야 합니다. 이 파일을 엽니다.

1. 저작권 고지 업데이트

INF 파일의 처음 2줄은 드라이버 패키지에 대한 저작권 알림입니다.

줄 1에는 회사의 연도와 이름이 포함됩니다. YYYY 문자를 현재 연도로 바꾸고 제조업체 이름을> 회사 이름으로 바꿉<니다.

줄 2에서는 제조업체 이름 및 디바이스 모델 정보를 포함하여 드라이버 INF의 내용을 설명합니다. <제조업체 이름을 회사 이름으로> 바꾸고 프린터 모델의> 문자를 <드라이버에서 지원하는 프린터의 모델 이름으로 바꿉니다.

예를 들어 연도가 2021이고 회사의 이름이 Fabrikam이고 인쇄 장치 모델이 1234인 경우 다음을 입력합니다.

; Copyright (c) 2021 Fabrikam
; INF file for the Fabrikam 1234 print driver

2. [버전] 섹션이 올바른지 확인합니다.

[버전]이 포함된 줄을 찾습니다.

이 줄이 표시되는지 확인하고 확인합니다.
```
ClassVer=4.0
```
이 줄이 표시되는지 확인하고 확인합니다.
```
Signature="$WINDOWS NT$"
```

3. [SourceDisksFiles] 섹션 구성

[SourceDisksFiles]가 포함된 줄을 찾습니다.

이 형식 아래에는 다음 줄이 있습니다.

MyV4PrintDriver.gpd=1
MyV4PrintDriver-manifest.ini=1
MyV4PrintDriverRenderFilter-PipelineConfig.xml=1
MyV4PrintDriverRenderFilter.dll=1

4. [DriverFiles] 섹션 구성

[DriverFiles]가 포함된 줄을 찾습니다.

이 형식 아래에는 다음 줄이 있습니다.

MyV4PrintDriver.gpd
MyV4PrintDriver-manifest.ini
MyV4PrintDriverRenderFilter-PipelineConfig.xml
MyV4PrintDriverRenderFilter.dll

5. [Standard.NT$ARCH$] 섹션 구성

[Standard.NT$ARCH$]가 포함된 줄을 찾습니다.

이 섹션에서는 Install 각 모델에 대한 INF 섹션을 참조합니다. 예를 들어 프린터 모델이 Fabrikam 1234인 경우 다음을 입력합니다.

"Fabrikam 1234"=DriverInstall, USBPRINT\\Fabrikam1234
"Fabrikam 1234"=DriverInstall, WSDPRINT\\Fabrikam1234

6. INF 파일에 PrinterDriverID 추가

Visual Studio의 솔루션 탐색기 MyV4PrintDriver 노드를 확장합니다.

드라이버 파일을 선택한 다음 속성 창에서 고유 식별자 필드의 값을 확인합니다. 드라이버 ID(GUID)입니다. 강조 표시하고 복사합니다.

INF 파일 의 [Standard.NT$ARCH$] 섹션에서 다음 줄을 입력합니다.

"Fabrikam 1234"=DriverInstall,

그런 다음 쉼표 다음에 이전 단계에서 복사한 GUID를 붙여넣습니다. 완성된 [Standard.NT$ARCH$] 섹션은 다음과 같습니다.

"Fabrikam 1234"=DriverInstall, {GUID}
"Fabrikam 1234"=DriverInstall, USBPRINT\Fabrikam1234
"Fabrikam 1234"=DriverInstall, WSDPRINT\Fabrikam1234

7. [문자열] 섹션 구성

[문자열]이 포함된 줄을 찾습니다.

이 아래에서 ManufacturerName 문자열의 정의를 찾을 수 있습니다. 제조업체 <이름을 회사의 이름으로> 바꿔 대상 프린터에 대한 제조업체 이름을 제공하고 ; 을 포함하는 나머지 줄을 삭제합니다. TODO:

예를 들어 회사의 이름이 Fabrikam인 경우 다음을 입력합니다.

ManufacturerName="Fabrikam"

8. INF 파일 저장

INF 파일을 완료하면 다음과 같이 표시됩니다.

; Copyright (c) 2021 Fabrikam
; INF file for the Fabrikam 1234 print driver

[Version]
Signature="$Windows NT$"
Class=Printer
ClassGuid={4D36E979-E325-11CE-BFC1-08002BE10318}
Provider=%ManufacturerName%
CatalogFile=MyV4PrintDriver.cat
ClassVer=4.0
DriverVer=03/17/2014,1.0.0.0
PnpLockdown=1

[Manufacturer]
%ManufacturerName%=Standard,NT$ARCH$

[Standard.NT$ARCH$]
"Fabrikam 1234"=DriverInstall, {GUID}
"Fabrikam 1234"=DriverInstall, USBPRINT\Fabrikam1234
"Fabrikam 1234"=DriverInstall, WSDPRINT\Fabrikam1234

[DriverInstall]
CopyFiles=DriverFiles

[DriverFiles]
MyV4PrintDriver.gpd
MyV4PrintDriver-manifest.ini
MyV4PrintDriverRenderFilter-PipelineConfig.xml
MyV4PrintDriverRenderFilter.dll

[DestinationDirs]
DefaultDestDir = 66000

[SourceDisksNames]
1 = %DiskName%,,,""

[SourceDisksFiles]
MyV4PrintDriver.gpd=1
MyV4PrintDriver-manifest.ini=1
MyV4PrintDriverRenderFilter-PipelineConfig.xml=1
MyV4PrintDriverRenderFilter.dll=1

[Strings]
ManufacturerName="Fabrikam"
DiskName="MyV4PrintDriver Installation Disk"

드라이버 파일 목록 업데이트

Visual Studio의 솔루션 탐색기 MyV4PrinterDriver 노드를 확장합니다.
MyV4PrintDriver.gpd 파일을 선택하고 드라이버 파일 노드로 끕니다.
MyV4PrintDriver-manifest.ini 동일한 작업을 수행합니다.

드라이버 패키지에 파이프라인 구성 파일 추가

솔루션 탐색기 MyV4PrintDriver 프로젝트를 선택하고 길게 누르거나 마우스 오른쪽 단추로 클릭한 다음 속성을 선택합니다.
MyV4PrintDriver 속성 페이지 창의 왼쪽 창에서 구성 속성을 확장합니다.
드라이버 설치를 확장한 다음 패키지 파일을 선택합니다.
오른쪽 창에서 선택한 다음 나열된 파일에서 <편집...> 행을 클릭합니다.
자리 표시자를 파이프라인 구성 파일../MyV4PrintDriver Render Filter/MyV4PrintDriverRenderFilter-PipelineConfig.xml의 상대 경로로 바꾼 다음 확인을 클릭합니다.

드라이버 패키지에 렌더링 필터에 대한 참조 추가

Visual Studio의 솔루션 탐색기 MyV4PrinterDriver 노드를 확장합니다.
참조 노드를 선택하고 길게(또는 마우스 오른쪽 단추로 클릭) -> 참조 추가를 선택합니다.
MyV4PrintDriver 렌더링 필터에 대한 확인란을 선택한 다음 확인을 선택합니다.

디버깅 및 배포를 위한 드라이버 솔루션 구성

솔루션 탐색기 MyV4PrintDriver 프로젝트를 선택하고 길게 누르거나 마우스 오른쪽 단추로 클릭한 다음 속성을 선택합니다.
MyV4PrintDriver 속성 페이지 창의 왼쪽 창에서 구성 속성을 확장합니다.
드라이버 설치를 확장한 다음 배포를 선택합니다. 오른쪽 창에서 다음을 수행합니다.
- 대상 컴퓨터 이름이 구성되어 있는지 확인합니다. 그렇지 않은 경우 "..."를 선택합니다. 디바이스 구성 마법사의 프롬프트에 따라 원격 대상 컴퓨터를 설정합니다.
- 배포 전에 이전 드라이버 버전 제거를 확인 합니다.
- 설치/다시 설치 및 확인을 선택한 다음, 드롭다운 상자에서 기본 프린터 드라이버 패키지 설치 작업을 선택합니다.
- 이름 주위에 따옴표가 없으면 선택적 인수 필드에 드라이버의 이름을 입력합니다.
- 확인을 선택합니다.

드라이버 서명 구성

솔루션 탐색기 MyV4PrintDriver 프로젝트를 선택하고 길게 누르거나 마우스 오른쪽 단추로 클릭한 다음 속성을 선택합니다.
MyV4PrintDriver 속성 페이지 창의 왼쪽 창에서 구성 속성을 확장합니다.
드라이버 서명을 확장한 다음 일반을 선택합니다.
오른쪽 창에서 서명 모드가 테스트 서명으로 설정되어 있는지 확인합니다.
테스트 인증서를 선택한 다음, 드롭다운 상자에서 테스트 인증서 만들기를 선택합니다.
TimeStampServer를 선택한 다음, 드롭다운 상자에서 Verisign을 선택합니다.
확인을 선택합니다.

드라이버 빌드 및 배포

솔루션 탐색기 솔루션 MyV4PrintDriver(2개 프로젝트)를 선택하고 길게(또는 마우스 오른쪽 단추로 클릭) 솔루션 빌드를 선택합니다.
빌드 프로세스가 완료되면 드라이버가 자동으로 설치됩니다. 출력 창에 오류가 없는지 확인합니다.

드라이버 테스트

플러그 앤 플레이 또는 프린터 추가 마법사를 사용하여 인쇄 큐를 만듭니다.

v4 프린터 드라이버의 INF 파일에 대한 자세한 내용은 V4 드라이버 INF를 참조하세요.

앞의 표에 있는 파일 외에도 MyV4PrintDriver 렌더링 필터 폴더가 만들어졌는지 확인합니다. 이 템플릿은 렌더링 필터 프로젝트 템플릿이며 XPS 렌더링 필터 및 XPS 필터 파이프라인 구성 파일을 빌드하기 위한 좋은 기반을 제공합니다. XPS 렌더링 필터에 대한 자세한 내용은 XPSDrv 렌더링 모듈을 참조 하세요.

다음을 통해 공유