DRIVER_INFO_8A結構 (winspool.h)

發行項
02/27/2024

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

Multi-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\0) 。

ftDriverDate

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

dwlDriverVersion

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

pszMfgName

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

pszOEMUrl

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

pszHardwareID

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

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 參數定義的旗標。

旗標名稱/值	意義	最低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
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 的 AddPrinterDriver 或 AddPrinterDriverEx，然後呼叫 Level 等於 6 或 8 的 GetPrinterDriver 或 EnumPrinterDrivers，DRIVER_INFO_8結構會以 pszMfgName、pszOEMUrl、pszHardwareID 和 pszProvider 設定為 NULL、dwlDriverVersion 設定為零，並將 ftDriverDate 設定為 (0,0) 。

規格需求

需求	值
標頭	winspool.h (包含 Winspool.h)

共用方式為

DRIVER_INFO_8A結構 (winspool.h)

語法

成員

備註

規格需求

意見反應

其他資源