DRIVER_INFO_8W構造体 (winspool.h)

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

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

ドライバーの名前 (QMS 810 など) を指定する null で終わる文字列へのポインター。

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

ドライバーが依存するファイルの名前を含む Multi-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

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

pszPrintProcessor

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

pszVendorSetup

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

pszzColorProfiles

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

pszInfPath

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

dwPrinterDriverAttributes

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

フラグ名/値	意味	最小 OS
PRINTER_DRIVER_PACKAGE_AWARE 0x00000001	プリンタードライバーは、ドライバーパッケージの一部です。	Windows Vista
PRINTER_DRIVER_XPS 0x00000002	プリンタードライバーは、「 XML Paper Specification: Overview」および「 Product Behavior, section <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 で終わる文字列へのポインター。 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_8W構造体 (winspool.h)

構文

メンバー

注釈

要件

フィードバック

その他のリソース