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 的 AddPrinterDriver 或 AddPrinterDriverEx 函数,则必须 NULL。
dwPrinterDriverAttributes
此成员指定打印机驱动程序相关属性。 如果对 DRIVER_INFO_8 使用 AddPrinterDriver 或 AddPrinterDriverEx 函数,则必须为零。 下表显示了为 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 的 AddPrinterDriver 或 AddPrinterDriverEx 函数,则必须 NULL。
ftMinInboxDriverVerDate
随 Windows 附带的任何驱动程序以及此驱动程序所依赖的最早允许日期。
dwlMinInboxDriverVerVersion
Windows 附带的任何驱动程序的最早允许版本,以及此驱动程序所依赖的驱动程序。
这些成员的字符串包含在用于添加驱动程序的 INF 文件中。
如果调用 AddPrinterDriver 或 Level 不等于 6 或 8 的 AddPrinterDriverEx, 然后调用 GetPrinterDriver 或 EnumPrinterDrivers 级别等于 6 或 8,DRIVER_INFO_8 结构将返回 pszMfgName、pszOEMUrl、pszHardwareID 和 pszProvider 设置为 NULL, dwlDriverVersion 设置为零,ftDriverDate 设置为 (0,0)。
要求 | 价值 |
---|---|
标头 | winspool.h (包括 Winspool.h) |