DRIVER_INFO_8W 구조체(winspool.h)
DRIVER_INFO_8 구조에는 프린터 드라이버 정보가 포함됩니다.
구문
typedef struct _DRIVER_INFO_8W {
DWORD cVersion;
LPWSTR pName;
LPWSTR pEnvironment;
LPWSTR pDriverPath;
LPWSTR pDataFile;
LPWSTR pConfigFile;
LPWSTR pHelpFile;
LPWSTR pDependentFiles;
LPWSTR pMonitorName;
LPWSTR pDefaultDataType;
LPWSTR pszzPreviousNames;
FILETIME ftDriverDate;
DWORDLONG dwlDriverVersion;
LPWSTR pszMfgName;
LPWSTR pszOEMUrl;
LPWSTR pszHardwareID;
LPWSTR pszProvider;
LPWSTR pszPrintProcessor;
LPWSTR pszVendorSetup;
LPWSTR pszzColorProfiles;
LPWSTR pszInfPath;
DWORD dwPrinterDriverAttributes;
LPWSTR pszzCoreDriverDependencies;
FILETIME ftMinInboxDriverVerDate;
DWORDLONG dwlMinInboxDriverVerVersion;
} DRIVER_INFO_8W, *PDRIVER_INFO_8W, *LPDRIVER_INFO_8W;
멤버
cVersion
이 멤버는 드라이버가 작성된 운영 체제 버전을 지정합니다. 현재 다음이 될 수 있습니다.
값 | 의미 |
---|---|
3 | Microsoft Windows 2000, XP 또는 Windows Vista용 드라이버입니다. |
pName
드라이버의 이름(예: QMS 810)을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pEnvironment
드라이버가 작성된 환경(예: Microsoft Windows 7, 8 또는 Windows Server 2012)을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pDriverPath
디바이스 드라이버가 포함된 파일의 전체 경로 및 파일 이름(예: C:\DRIVERS\Pscript.dll)을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pDataFile
드라이버 데이터가 포함된 파일의 전체 경로 및 파일 이름(예: C:\DRIVERS\Qms810.ppd)을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pConfigFile
디바이스 드라이버의 구성 동적 링크 라이브러리(예: C:\DRIVERS\Pscrptui.dll)에 대한 파일 이름 또는 전체 경로 및 파일 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pHelpFile
디바이스 드라이버의 도움말 파일(예: C:\DRIVERS\Pscrptui.hlp)의 파일 이름 또는 전체 경로 및 파일 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pDependentFiles
드라이버가 의존하는 파일의 이름을 포함하는 다중 SZ 문자열에 대한 포인터입니다. 파일 이름은 연속된 일련의 0으로 끝나는 문자열과 빈 문자열로 저장됩니다. 예를 들어 Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txt\0\0입니다. 여기서 \0은 종료되는 null 문자를 나타냅니다.
pMonitorName
언어 모니터(예: "PJL 모니터")를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 멤버는 NULL 일 수 있으며 양방향 통신이 가능한 프린터에 대해서만 지정해야 합니다.
pDefaultDataType
인쇄 작업의 기본 데이터 형식(예: "EMF")을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pszzPreviousNames
이 드라이버와 호환되는 이전 프린터 드라이버 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다(예: OldName1\0OldName2\0\0).
ftDriverDate
드라이버 파일에 코딩된 드라이버 패키지의 날짜입니다.
dwlDriverVersion
드라이버의 버전 번호입니다. 이는 드라이버의 버전 구조에서 나옵니다.
pszMfgName
제조업체의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pszOEMUrl
제조업체의 URL을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pszHardwareID
프린터 드라이버의 하드웨어 ID를 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pszProvider
프린터 드라이버의 공급자를 지정하는 null로 끝나는 문자열에 대한 포인터입니다(예: "Microsoft Windows 8").
pszPrintProcessor
프린터 드라이버와 연결된 인쇄 프로세서의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pszVendorSetup
프린터 드라이버와 연결된 공급업체 설정의 공급업체 설정 DLL 및 진입점을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pszzColorProfiles
프린터 드라이버와 연결된 모든 색 프로필을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
pszInfPath
프린터 드라이버가 설치된 드라이버 저장소 내의 INF 파일 경로를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. DRIVER_INFO_8 AddPrinterDriver 또는 AddPrinterDriverEx 함수를 사용하는 경우 NULL이어야 합니다.
dwPrinterDriverAttributes
이 멤버는 프린터 드라이버 관련 속성을 지정합니다. DRIVER_INFO_8 AddPrinterDriver 또는 AddPrinterDriverEx 함수를 사용하는 경우 0이어야 합니다. 다음 표에서는 dwPrinterDriverAttributes 매개 변수에 대해 정의된 플래그를 보여줍니다.
플래그 이름/값 | 의미 | 최소 OS |
---|---|---|
PRINTER_DRIVER_PACKAGE_AWARE 0x00000001 |
프린터 드라이버는 드라이버 패키지의 일부입니다. | Windows Vista |
PRINTER_DRIVER_XPS 0x00000002 |
프린터 드라이버는 XML 용지 사양: 개요 및 제품 동작 섹션 <27>에 설명된 Microsoft XPS 형식을 지원합니다. | Windows 8 Windows Server 2012 |
PRINTER_DRIVER_SANDBOX_ENABLED 0x00000004 |
프린터 드라이버는 프린터 드라이버 격리와 호환됩니다. 자세한 내용은 제품 동작 섹션 <28을 참조하세요>. | Windows 7 Windows Server 2008 R2 |
PRINTER_DRIVER_CLASS 0x00000008 |
프린터 드라이버는 클래스 프린터 드라이버입니다. | Windows 8 Windows Server 2012 |
PRINTER_DRIVER_DERIVED 0x00000010 |
프린터 드라이버는 파생된 프린터 드라이버입니다. | Windows 8 Windows Server 2012 |
PRINTER_DRIVER_NOT_SHAREABLE 0x00000020 |
이 프린터 드라이버를 사용하는 프린터는 공유할 수 없습니다. | Windows 8 Windows Server 2012 |
PRINTER_DRIVER_CATEGORY_FAX 0x00000040 |
프린터 드라이버는 팩스 프린터와 함께 사용하기 위한 것입니다. | Windows 8 Windows Server 2012 |
PRINTER_DRIVER_CATEGORY_FILE 0x00000080 |
프린터 드라이버는 파일 프린터와 함께 사용하기 위한 것입니다. | Windows 8 Windows Server 2012 |
PRINTER_DRIVER_CATEGORY_VIRTUAL 0x00000100 |
프린터 드라이버는 가상 프린터와 함께 사용하기 위한 것입니다. | Windows 8 Windows Server 2012 |
PRINTER_DRIVER_CATEGORY_SERVICE 0x00000200 |
프린터 드라이버는 서비스 프린터와 함께 사용하기 위한 것입니다. | Windows 8 Windows Server 2012 |
PRINTER_DRIVER_SOFT_RESET_REQUIRED 0x00000400 |
이 프린터 드라이버를 사용하는 프린터는 [USB 디바이스 클래스 정의](USB 디바이스 클래스 정의)에 설명된 지침을 따라야 합니다. 자세한 내용은 제품 동작 섹션 <36을 참조하세요>. | Windows 8 Windows Server 2012 |
PRINTER_DRIVER_CATEGORY_3D 0x00001000 |
프린터 드라이버는 3D 프린터와 함께 사용하기 위한 것입니다. | Windows 8 Windows Server 2012 |
pszzCoreDriverDependencies
pszInfPath로 정의된 드라이버 패키지에 대한 모든 핵심 프린터 드라이버 종속성을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. DRIVER_INFO_8 AddPrinterDriver 또는 AddPrinterDriverEx 함수를 사용하는 경우 NULL이어야 합니다.
ftMinInboxDriverVerDate
Windows와 함께 제공되고 이 드라이버가 의존하는 드라이버의 가장 빠른 허용 날짜입니다.
dwlMinInboxDriverVerVersion
Windows와 함께 제공되고 이 드라이버가 의존하는 드라이버의 가장 초기 허용 버전입니다.
설명
이러한 멤버에 대한 문자열은 드라이버를 추가하는 데 사용되는 INF 파일에 포함되어 있습니다.
수준이 6 또는 8이 아닌 AddPrinterDriver 또는 AddPrinterDriverEx 를 호출하는 경우 그런 다음 수준이 6 또는 8인 GetPrinterDriver 또는 EnumPrinterDrivers 를 호출하고 , pszMfgName , pszOEMUrl, pszHardwareID 및 pszProvider를 NULL로 설정하고, dwlDriverVersion을 0으로 설정하고, ftDriverDate를 0으로 설정하여 DRIVER_INFO_8 구조가 반환됩니다.
요구 사항
요구 사항 | 값 |
---|---|
헤더 | winspool.h(Winspool.h 포함) |