DRIVER_INFO_8W结构 (winspool.h)

项目
03/13/2023

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

指向以 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 监视器”) 。此成员可以为 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 文件的路径。如果将 AddPrinterDriver 或 AddPrinterDriverEx 函数与 DRIVER_INFO_8 结合使用，则必须为 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 设备类定义] (USB 设备类定义中概述的准则。有关详细信息，请参阅产品行为，第 36> 节<	Windows 8 Windows Server 2012
PRINTER_DRIVER_CATEGORY_3D 0x00001000	打印机驱动程序适用于 3D 打印机。	Windows 8 Windows Server 2012

pszzCoreDriverDependencies

指向以 null 结尾的字符串的指针，该字符串包含 pszInfPath 定义的驱动程序包的所有核心打印机驱动程序依赖项。如果将 AddPrinterDriver 或 AddPrinterDriverEx 函数与 DRIVER_INFO_8 结合使用，则必须为 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_8W结构 (winspool.h)

语法

成员

注解

要求

反馈

反馈

其他资源