共用方式為

DRIVER_INFO_8A結構 （winspool.h）

  • 發行項

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 紙張規格：概觀中所述的 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裝置類別定義中所述的指導方針。 如需詳細資訊，請參閱 產品行為一節，<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 檔案中。

如果您呼叫 AddPrinterDriver 或 AddPrinterDriverEx Level 不等於 6 或 8， 然後呼叫 getPrinterDriver 或 EnumPrinterDrivers Level 等於 6 或 8，DRIVER_INFO_8 結構會以 pszMfgName、pszOEMUrl、pszHardwareID 和 pszProvider 設定為 NULL， dwlDriverVersion 設定為零，ftDriverDate 設定為 （0,0）。

要求

要求 價值
標頭 winspool.h （包括 Winspool.h）