DRIVER_INFO_8W結構 (winspool.h)

發行項
02/27/2024

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

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 裝置類別定義] (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_8W結構 (winspool.h)

語法

成員

備註

規格需求

意見反應

其他資源