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

指向以 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

指向指定语言监视器(例如“PJL 监视器”)的以 null 结尾的字符串的指针。 此成员可以 NULL,并且只能为能够双向通信的打印机指定。

pDefaultDataType

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

pszzPreviousNames

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

ftDriverDate

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

dwlDriverVersion

驱动程序的版本号。 这源于驱动程序的版本结构。

pszMfgName

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

pszOEMUrl

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

pszHardwareID

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

pszProvider

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

pszPrintProcessor

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

pszVendorSetup

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

pszzColorProfiles

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

pszInfPath

指向以 null 结尾的字符串的指针,该字符串指定安装打印机驱动程序的驱动程序存储区内的 INF 文件的路径。 如果使用具有 DRIVER_INFO_8 的 AddPrinterDriverAddPrinterDriverEx 函数,则必须 NULL

dwPrinterDriverAttributes

此成员指定打印机驱动程序相关属性。 如果对 DRIVER_INFO_8 使用 AddPrinterDriverAddPrinterDriverEx 函数,则必须为零。 下表显示了为 dwPrinterDriverAttributes 参数定义的标志。

标志名称/值 意义 最低 OS
PRINTER_DRIVER_PACKAGE_AWARE

0x00000001
打印机驱动程序是驱动程序包的一部分。 Windows Vista
PRINTER_DRIVER_XPS

0x00000002
打印机驱动程序支持 XML 纸张规范中所述的 Microsoft XPS 格式:概述,以及 产品行为部分,<27> 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定义的驱动程序包的所有核心打印机驱动程序依赖项。 如果使用具有 DRIVER_INFO_8 的 AddPrinterDriverAddPrinterDriverEx 函数,则必须 NULL

ftMinInboxDriverVerDate

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

dwlMinInboxDriverVerVersion

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

言论

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

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

要求

要求 价值
标头 winspool.h (包括 Winspool.h)