DRIVER_UPGRADE_INFO_2構造体 (winddiui.h)

DRIVER_UPGRADE_INFO_2構造体は、プリンター インターフェイス DLL の DrvUpgradePrinter 関数への入力として使用されます。

構文

typedef struct _DRIVER_UPGRADE_INFO_2 {
  LPTSTR pPrinterName;
  LPTSTR pOldDriverDirectory;
  DWORD  cVersion;
  LPTSTR pName;
  LPTSTR pEnvironment;
  LPTSTR pDriverPath;
  LPTSTR pDataFile;
  LPTSTR pConfigFile;
  LPTSTR pHelpFile;
  LPTSTR pDependentFiles;
  LPTSTR pMonitorName;
  LPTSTR pDefaultDataType;
  LPTSTR pszzPreviousNames;
} DRIVER_UPGRADE_INFO_2, *PDRIVER_UPGRADE_INFO_2;

メンバー

pPrinterName

プリンターの名前を指定する NULL で終わる文字列へのポインター。 詳細については、「解説」を参照してください。

pOldDriverDirectory

古いプリンター ドライバー ファイルが見つかるローカル ディレクトリを指定する NULL で終わる文字列へのポインター。

cVersion

ドライバーが書き込まれたオペレーティング システムのバージョンを指定します。

pName

ドライバーの名前 ("QMS 810" など) を指定する NULL で終わる文字列へのポインター。 詳細については、「解説」を参照してください。

pEnvironment

ドライバーが書き込まれた環境 ("Windows NT x86" や "Windows Itanium" など) を指定する NULL で終わる文字列へのポインター。

pDriverPath

デバイス ドライバー ("pscript.dll" など) を含むファイルのファイル名または完全パスとファイル名を指定する NULL で終わる文字列へのポインター。

pDataFile

ドライバー データを含むファイルのファイル名または完全なパスとファイル名を指定する NULL で終わる文字列へのポインター (例: "qms810.ppd")。

pConfigFile

デバイス ドライバーの構成ダイナミック リンク ライブラリ ("pscrptui.dll" など) のファイル名または完全なパスとファイル名を指定する NULL で終わる文字列へのポインター。

pHelpFile

デバイス ドライバーのヘルプ ファイルのファイル名または完全なパスとファイル名を指定する null で終わる文字列へのポインター。

pDependentFiles

ドライバーが依存するファイルを指定する NULL で終わる文字列へのポインター。 文字列内の各ファイル名も null 文字で終わる (たとえば、"pscript.dll\0qms810.ppd\0pscrptui.dll\0pscrptui.hlp\0pstest.txt\0\0")。

pMonitorName

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

pDefaultDataType

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

pszzPreviousNames

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

注釈

pDriverUpgradeInfo パラメーターがDRIVER_UPGRADE_INFO_2構造体を指す DrvUpgradePrinter が呼び出されると、pPrinterName メンバーは更新するプリンターの名前を含む文字列を指します。 pName メンバーは、更新するプリンター ドライバーの名前を含む文字列を指します。これは、必ずしも pPrinterName メンバーが指す名前を持つプリンターのドライバーではありません。

これがどのように発生するかを確認するには、コンピューターが 2 台のプリンターに接続されており、1 台のプリンターの名前が "Acme Plotter" で、もう 1 台のプリンターの名前が "Acme RasterMaster" であるとします。 また、両方のドライバーが共通のドライバー ファイル (plotui.dll) を共有しているとします。 "Acme Plotter" ドライバーが AddPrinterDriverEx 関数の呼び出しによって更新されると (Microsoft Windows SDKドキュメントで説明されています)、両方のドライバーがアップグレードの影響を受けるファイルを使用するため、両方のプリンターに対して DrvUpgradePrinter が呼び出されます。 どちらの呼び出しでも、 pName メンバーは "Acme Plotter" ( AddPrinterDriverEx の呼び出しで使用されるプリンター ドライバーの名前) を指します。 ただし、 pPrinterName メンバーが指す文字列は、DrvUpgradePrinter の呼び出しの両方で異なります。 各呼び出しで、 pPrinterName は更新されるプリンターの名前を指します。

要件

こちらもご覧ください

DRIVER_UPGRADE_INFO_1

DrvUpgradePrinter