DRIVER_INFO_8A 構造体 (winspool.h)

[アーティクル]
03/13/2023

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

デバイスドライバーを含むファイルのファイル名または完全なパスとファイル名 (たとえば、C:\DRIVERS\Pscript.dll) を指定する null で終わる文字列へのポインター。

pDataFile

ドライバーデータを含むファイルのファイル名または完全なパスとファイル名を指定する null で終わる文字列へのポインター (たとえば、C:\DRIVERS\Qms810.ppd)。

pConfigFile

デバイスドライバーの構成ダイナミックリンクライブラリ (たとえば、C:\DRIVERS\Pscrptui.dll) のファイル名または完全なパスとファイル名を指定する null で終わる文字列へのポインター。

pHelpFile

デバイスドライバーのヘルプファイル (C:\DRIVERS\Pscrptui.hlp など) のファイル名または完全なパスとファイル名を指定する null で終わる文字列へのポインター。

pDependentFiles

ドライバーが依存するファイルの名前を含むマルチ SZ 文字列へのポインター。ファイル名は、連続する一連の 0 で終わる文字列の後に空の文字列として格納されます。たとえば、Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txt\0\0 です。\0 は終端の null 文字を表します。

pMonitorName

言語モニター ("PJL モニター" など) を指定する null で終わる文字列へのポインター。このメンバーは NULL にすることができ、双方向通信が可能なプリンターに対してのみ指定する必要があります。

pDefaultDataType

印刷ジョブの既定のデータ型 ("EMF" など) を指定する null で終わる文字列へのポインター。

pszzPreviousNames

このドライバーと互換性のある以前のプリンタードライバー名 (たとえば、OldName1\0OldName2\0\0) を指定する null で終わる文字列へのポインター。

ftDriverDate

ドライバーファイルにコード化されたドライバーパッケージの日付。

dwlDriverVersion

ドライバーのバージョン番号。これは、ドライバーのバージョン構造から取得されます。

pszMfgName

製造元の名前を指定する null で終わる文字列へのポインター。

pszOEMUrl

製造元の URL を指定する null で終わる文字列へのポインター。

pszHardwareID

プリンタードライバーのハードウェア ID を指定する null で終わる文字列へのポインター。

pszProvider

プリンタードライバーのプロバイダーを指定する null で終わる文字列へのポインター (たとえば、"Microsoft Windows 8")。

pszPrintProcessor

プリンタードライバーに関連付けられている印刷プロセッサの名前を指定する null で終わる文字列へのポインター。

pszVendorSetup

プリンタードライバーに関連付けられているベンダーセットアップのベンダーセットアップ DLL とエントリポイントを指定する null で終わる文字列へのポインター。

pszzColorProfiles

プリンタードライバーに関連付けられているすべてのカラープロファイルを指定する null で終わる文字列へのポインター。

pszInfPath

プリンタードライバーがインストールされたドライバーストア内の INF ファイルのパスを指定する null で終わる文字列へのポインター。 addPrinterDriver 関数または AddPrinterDriverEx 関数をDRIVER_INFO_8と共に使用する場合は NULL にする必要があります。

dwPrinterDriverAttributes

このメンバーは、プリンタードライバーに関連するプロパティを指定します。 DRIVER_INFO_8で AddPrinterDriver または AddPrinterDriverEx 関数を使用する場合は、0 にする必要があります。次の表は、 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	プリンタードライバーは、 FAX プリンターでの使用を目的としています。	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

pszInfPath で定義されているドライバーパッケージのすべての主要なプリンタードライバーの依存関係を含む null で終わる文字列へのポインター。 DRIVER_INFO_8で AddPrinterDriver または AddPrinterDriverEx 関数を使用する場合は NULL にする必要があります。

ftMinInboxDriverVerDate

Windows に付属し、このドライバーが依存するすべてのドライバーの最も古い日付が許可されます。

dwlMinInboxDriverVerVersion

Windows に付属し、このドライバーが依存するすべてのドライバーの最も古いバージョンが許可されています。

注釈

これらのメンバーの文字列は、ドライバーの追加に使用される INF ファイルに含まれています。

レベルが 6 または 8 に等しくない AddPrinterDriver または AddPrinterDriverEx を呼び出す場合は、次に、Level が 6 または 8 の GetPrinterDriver または EnumPrinterDrivers を呼び出すと、pszMfgName、pszOEMUrl、pszHardwareID、pszProvider が NULL に設定され、dwlDriverVersion が 0 に設定され、ftDriverDate が (0,0) に設定された状態でDRIVER_INFO_8構造体が返されます。

要件

要件	値
Header	winspool.h (Winspool.h を含む)

次の方法で共有

DRIVER_INFO_8A 構造体 (winspool.h)

構文

メンバー

注釈

要件

フィードバック

その他のリソース