DRIVER_INFO_8A 结构 (winspool.h)

项目
03/13/2023

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

语法

typedef struct _DRIVER_INFO_8A {
  DWORD     cVersion;
  LPSTR     pName;
  LPSTR     pEnvironment;
  LPSTR     pDriverPath;
  LPSTR     pDataFile;
  LPSTR     pConfigFile;
  LPSTR     pHelpFile;
  LPSTR     pDependentFiles;
  LPSTR     pMonitorName;
  LPSTR     pDefaultDataType;
  LPSTR     pszzPreviousNames;
  FILETIME  ftDriverDate;
  DWORDLONG dwlDriverVersion;
  LPSTR     pszMfgName;
  LPSTR     pszOEMUrl;
  LPSTR     pszHardwareID;
  LPSTR     pszProvider;
  LPSTR     pszPrintProcessor;
  LPSTR     pszVendorSetup;
  LPSTR     pszzColorProfiles;
  LPSTR     pszInfPath;
  DWORD     dwPrinterDriverAttributes;
  LPSTR     pszzCoreDriverDependencies;
  FILETIME  ftMinInboxDriverVerDate;
  DWORDLONG dwlMinInboxDriverVerVersion;
} DRIVER_INFO_8A, *PDRIVER_INFO_8A, *LPDRIVER_INFO_8A;

成员

cVersion

此成员指定为其编写驱动程序的操作系统版本。目前可以是以下内容。

值	含义
3	适用于 Microsoft Windows 2000、XP 或 Windows Vista 的驱动程序。

pName

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

pEnvironment

指向以 null 结尾的字符串的指针，该字符串指定 (为其编写驱动程序的环境，例如 Microsoft Windows 7、8 或 Windows Server 2012) 。

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

指向多 SZ 字符串的指针，该字符串包含驱动程序所依赖的文件的名称。文件名存储为连续的零端字符串系列，后跟空字符串。例如，Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txt\0\0，其中 \0 表示终止 null 字符。

pMonitorName

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

pDefaultDataType

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

pszzPreviousNames

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

ftDriverDate

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

dwlDriverVersion

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

pszMfgName

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

pszOEMUrl

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

pszHardwareID

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

pszProvider

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

pszPrintProcessor

指向以 null 结尾的字符串的指针，该字符串指定与打印机驱动程序关联的打印处理器的名称。

pszVendorSetup

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

pszzColorProfiles

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

pszInfPath

指向以 null 结尾的字符串的指针，该字符串指定从中安装打印机驱动程序的驱动程序存储中的 INF 文件的路径。如果使用具有DRIVER_INFO_8的 AddPrinterDriver 或 AddPrinterDriverEx 函数，则必须为 NULL。

dwPrinterDriverAttributes

此成员指定打印机驱动程序相关的属性。如果将 AddPrinterDriver 或 AddPrinterDriverEx 函数与 DRIVER_INFO_8 一起使用，则必须为零。下表显示了已为 dwPrinterDriverAttributes 参数定义的标志。

标志名称/值	含义	最低操作系统
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
PRINTER_DRIVER_CATEGORY_3D 0x00001000	打印机驱动程序适用于 3D 打印机。	Windows 8 Windows Server 2012

pszzCoreDriverDependencies

指向以 null 结尾的字符串的指针，该字符串包含 pszInfPath 定义的驱动程序包的所有核心打印机驱动程序依赖项。如果使用具有DRIVER_INFO_8的 AddPrinterDriver 或 AddPrinterDriverEx 函数，则必须为 NULL。

ftMinInboxDriverVerDate

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

dwlMinInboxDriverVerVersion

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

注解

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

如果调用 Level 不等于 6 或 8 的 AddPrinterDriverDriver 或 AddPrinterDriverEx，然后调用级别等于 6 或 8 的 GetPrinterDriver 或 EnumPrinterDrivers，返回DRIVER_INFO_8结构，pszMfgName、pszOEMUrl、pszHardwareID 和 pszProvider 设置为 NULL，dwlDriverVersion 设置为零，ftDriverDate 设置为 (0,0) 。

要求

要求	值
Header	winspool.h (包括 Winspool.h)

通过

DRIVER_INFO_8A 结构 (winspool.h)

语法

成员

注解

要求

反馈

其他资源