DRIVER_INFO_8W構造体 (winspool.h)

[アーティクル]
02/07/2025

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

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

pHelpFile

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

pDependentFiles

ドライバーが依存するファイルの名前を含むマルチ SZ 文字列へのポインター。ファイル名は、連続する一連の 0 で終わる文字列の後に空の文字列が続いて格納されます。たとえば、\0\0 Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txtします。\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 を使用する場合、または DRIVER_INFO_8 で AddPrinterDriverEx 関数をする場合は、null する必要があります。

dwPrinterDriverAttributes

このメンバーは、プリンタードライバーに関連するプロパティを指定します。 AddPrinterDriver を使用する場合、または DRIVER_INFO_8 で AddPrinterDriverEx 関数をする場合は、0 にする必要があります。次の表に、dwPrinterDriverAttributes パラメーターに対して定義されているフラグを示します。

フラグ名/値	意味	最小 OS
PRINTER_DRIVER_PACKAGE_AWARE 0x00000001	プリンタードライバーは、ドライバーパッケージの一部です。	Windows Vista
PRINTER_DRIVER_XPS 0x00000002	プリンタードライバーは、「XML Paper Specification: Overview」および「Product Behavior」(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 デバイスクラス定義](USB デバイスクラス定義に記載されているガイドラインに従う必要があります。詳細については、「製品の動作」セクション <36> を参照してください。	Windows 8 Windows Server 2012
PRINTER_DRIVER_CATEGORY_3D 0x00001000	プリンタードライバーは、3D プリンターでの使用を目的としています。	Windows 8 Windows Server 2012

pszzCoreDriverDependencies

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

ftMinInboxDriverVerDate

Windows に付属していて、このドライバーが依存しているドライバーの、最も早く許可された日付。

dwlMinInboxDriverVerVersion

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

備考

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

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

必要条件

要件	価値
ヘッダー	winspool.h (Winspool.h を含む)

次の方法で共有

DRIVER_INFO_8W構造体 (winspool.h)

構文

メンバーズ

備考

必要条件

フィードバック

その他のリソース