DRIVER_INFO_8结构

项目
06/12/2023

包含打印机驱动程序信息。

语法

typedef struct _DRIVER_INFO_8 {
  DWORD     cVersion;
  LPTSTR    pName;
  LPTSTR    pEnvironment;
  LPTSTR    pDriverPath;
  LPTSTR    pDataFile;
  LPTSTR    pConfigFile;
  LPTSTR    pHelpFile;
  LPTSTR    pDependentFiles;
  LPTSTR    pMonitorName;
  LPTSTR    pDefaultDataType;
  LPTSTR    pszzPreviousNames;
  FILETIME  ftDriverDate;
  DWORDLONG dwlDriverVersion;
  LPTSTR    pszMfgName;
  LPTSTR    pszOEMUrl;
  LPTSTR    pszHardwareID;
  LPTSTR    pszProvider;
  LPTSTR    pszPrintProcessor;
  LPTSTR    pszVendorSetup;
  LPTSTR    pszzColorProfiles;
  LPTSTR    pszInfPath;
  DWORD     dwPrinterDriverAttributes;
  LPTSTR    pszzCoreDriverDependencies;
  FILETIME  ftMinInboxDriverVerDate;
  DWORDLONG dwlMinInboxDriverVerVersion;
} DRIVER_INFO_8, *PDRIVER_INFO_8, *LPDRIVER_INFO_8;

成员

cVersion

为其编写驱动程序的操作系统版本。支持的值为 3。

pName

指向以 null 结尾的字符串的指针，该字符串指定驱动程序的名称 (例如 QMS 810) 。

pEnvironment

指向以 null 结尾的字符串的指针，该字符串指定 (为其写入驱动程序的环境，例如 Windows x86、Windows IA64 和 Windows x64。

pDriverPath

指向以 null 结尾的字符串的指针，该字符串指定包含设备驱动程序 (的文件的文件名或完整路径和文件名，例如，C:\DRIVERS\Pscript.dll) 。

pDataFile

指向以 null 结尾的字符串的指针，该字符串指定包含驱动程序数据的文件的文件名或完整路径和文件名 (例如 C：\DRIVERS\Qms810.ppd) 。

pConfigFile

指向以 null 结尾的字符串的指针，该字符串指定设备驱动程序的配置动态链接库的文件名或完整路径和文件名 (，例如，C:\DRIVERS\Pscrptui.dll) 。

pHelpFile

指向以 null 结尾的字符串的指针，该字符串指定设备驱动程序帮助文件的文件名或完整路径和文件名， (例如 C：\DRIVERS\Pscrptui.hlp) 。

pDependentFiles

指向包含以 null 结尾的字符串序列的 MultiSZ 缓冲区的指针。缓冲区中每个以 null 结尾的字符串都包含驱动程序所依赖的文件的名称。字符串序列由空的零长度字符串终止。如果 pDependentFiles 不为 NULL 且不包含任何文件名，它将指向包含两个空字符串的缓冲区。

pMonitorName

指向以 null 结尾的字符串的指针，该字符串指定语言监视器 (例如，“PJL 监视器”) 。此成员可以为 NULL ，应仅为能够进行双向通信的打印机指定。

pDefaultDataType

指向以 null 结尾的字符串的指针，该字符串指定打印作业的默认数据类型 (例如“EMF”) 。

pszzPreviousNames

指向以 null 结尾的字符串的指针，该字符串指定与此驱动程序兼容的先前打印机驱动程序名称。例如，OldName1\0OldName2\0\0。

ftDriverDate

驱动程序包的日期，如驱动程序文件中的编码。

dwlDriverVersion

驱动程序的版本号。这来自驱动程序的版本结构。

pszMfgName

指向以 null 结尾的字符串的指针，该字符串指定制造商的名称。

pszOEMUrl

指向以 null 结尾的字符串的指针，该字符串指定制造商的 URL。

pszHardwareID

指向以 null 结尾的字符串的指针，该字符串指定打印机驱动程序的硬件 ID。

pszProvider

指向以 null 结尾的字符串的指针，该字符串指定打印机驱动程序 (提供程序，例如“Microsoft Windows 2000”) 。

pszPrintProcessor

指向以 null 结尾的字符串的指针，该字符串指定打印处理器 (例如，“WinPrint”) 。

pszVendorSetup

指向以 null 结尾的字符串的指针，该字符串指定供应商的驱动程序设置 DLL 和入口点。

pszzColorProfiles

指向以 null 结尾的字符串的指针，该字符串指定与驱动程序关联的颜色配置文件。

pszInfPath

指向以 null 结尾的字符串的指针，该字符串指定驱动程序存储区中驱动程序的 .inf 文件的路径。 (请参阅 Remarks.) 如果DRIVER_INFO_8传递给 AddPrinterDriver 或 AddPrinterDriverEx，则必须为 NULL。

dwPrinterDriverAttributes

打印机驱动程序的属性标志。如果将DRIVER_INFO_8传递给 AddPrinterDriver 或 AddPrinterDriverEx，则必须为 0。否则，它可以是以下标志的任意组合：

标志名称/值	含义	最低操作系统
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 设备类定义中概述的准则。有关详细信息，请参阅产品行为，第 36> 节<	Windows 8 Windows Server 2012

pszzCoreDriverDependencies

指向以 null 结尾的多字符串的指针，该字符串指定驱动程序所依赖的所有核心打印机驱动程序。如果将DRIVER_INFO_8传递给 AddPrinterDriver 或 AddPrinterDriverEx，则必须为 NULL。

ftMinInboxDriverVerDate

Windows 随附的任何驱动程序的最早允许日期，以及此驱动程序所依赖的日期。

dwlMinInboxDriverVerVersion

Windows 附带的、此驱动程序所依赖的任何驱动程序的最早允许版本。

备注

这些成员的字符串包含在用于添加驱动程序的 .inf 文件中。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	Winspool.h (包括 Windows.h)
Unicode 和 ANSI 名称	_DRIVER_INFO_8W (Unicode) 和 _DRIVER_INFO_8A (ANSI)

另请参阅

打印
打印后台处理程序 API 结构
AddPrinterDriver
AddPrinterDriverEx

通过

DRIVER_INFO_8结构

语法

成员

备注

要求

另请参阅

反馈

其他资源