Share via


DRIVER_INFO_8 結構

包含印表機驅動程式資訊。

語法

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

MultiSZ 緩衝區的指標,其中包含一連串以 Null 結束的字串。 緩衝區中的每個 Null 終止字串都包含驅動程式相依的檔案名。 字串序列會以空的長度為零的字串終止。 如果 pDependentFiles 不是 Null 且不包含任何檔案名,則會指向包含兩個空字串的緩衝區。

pMonitorName

以 Null 結尾字串的指標,指定語言監視器 (例如「PJL 監視器」) 。 這個成員可以是 Null ,而且應該只針對能夠雙向通訊的印表機指定。

pDefaultDataType

null 終止字串的指標,指定列印工作的預設資料類型 (,例如 「EMF」) 。

pszzPreviousNames

Null 終止字串的指標,指定與這個驅動程式相容的先前印表機驅動程式名稱。 例如,OldName1\0OldName2\0\0。

ftDriverDate

驅動程式套件的日期,如驅動程式檔案中的程式碼所示。

dwlDriverVersion

驅動程式的版本號碼。 這來自驅動程式的版本結構。

pszMfgName

指定制造商名稱之 Null 終止字串的指標。

pszOEMUrl

指定制造商 URL 之 Null 終止字串的指標。

pszHardwareID

指定印表機驅動程式硬體識別碼之 Null 終止字串的指標。

pszProvider

指定印表機驅動程式提供者 (的 Null 終止字串指標,例如「Microsoft Windows 2000」) 。

pszPrintProcessor

以 Null 終止的字串指標,指定列印處理器 (例如 「WinPrint」) 。

pszVendorSetup

指定廠商驅動程式設定 DLL 和進入點之 Null 終止字串的指標。

pszzColorProfiles

Null 終止字串的指標,指定與驅動程式相關聯的色彩設定檔。

pszInfPath

Null 終止字串的指標,指定驅動程式存放區中驅動程式 .inf 檔案的路徑。 (請參閱備註.) 如果DRIVER_INFO_8傳遞至AddPrinterDriverAddPrinterDriverEx,這必須是Null

dwPrinterDriverAttributes

印表機驅動程式的屬性旗標。 如果DRIVER_INFO_8傳遞至 AddPrinterDriverAddPrinterDriverEx,這必須是 0。 否則,它可以是下列旗標的任何組合:

旗標名稱/值 意義 最低 OS
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傳遞至AddPrinterDriverAddPrinterDriverEx,這必須是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