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
ドライバーが書き込まれたオペレーティング システムのバージョンを指定します。
| 価値 | オペレーティング システム |
|---|---|
| 0 | Windows 95/98/Me |
| 1 | Windows NT 3.1 から Windows NT 3.51 |
| 2 | Windows NT 4.0 |
| 3 | Windows 2000 以降 |
pName
ドライバーの名前を指定する NULL で終わる文字列へのポインター (例: "QMS 810")。 詳細については、「解説」セクションを参照してください。
pEnvironment
ドライバーが書き込まれた環境 ("Windows NT x86" や "Windows Itanium" など) を指定する NULL で終わる文字列へのポインター。
pDriverPath
デバイス ドライバーを含むファイルのファイル名または完全なパスとファイル名を指定する NULL で終わる文字列へのポインター ("pscript.dll"など)。
pDataFile
ドライバー データを含むファイルのファイル名または完全なパスとファイル名を指定する NULL で終わる文字列へのポインター (例: "qms810.ppd")。
pConfigFile
デバイス ドライバーの構成ダイナミック リンク ライブラリのファイル名または完全なパスとファイル名を指定する NULL で終わる文字列へのポインター (例: "pscrptui.dll")。
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 メンバーが指すプリンターのドライバーであるとは限りません。
これがどのように発生するかを確認するには、1 台のコンピューターが 2 台のプリンターに接続され、1 台のプリンターのドライバーが "Acme Plotter" という名前で、もう 1 台のプリンターが "Acme RasterMaster" という名前であるとします。 また、両方のドライバーが共通のドライバー ファイル plotui.dll共有しているとします。 AddPrinterDriverEx 関数 (Microsoft Windows SDK ドキュメントで説明) の呼び出しによって "Acme Plotter" ドライバーが更新されると、両方のドライバーがアップグレードの影響を受けるファイルを使用するため、両方のプリンターに対して DrvUpgradePrinter が呼び出されます。 どちらの呼び出しでも、pName メンバーは、AddPrinterDriverEx 呼び出しで使用されるプリンター ドライバーの名前である "Acme Plotter" を指します。 ただし、pPrinterName メンバーが指す文字列は、DrvUpgradePrinter の呼び出しの両方で異なります。 各呼び出しで、pPrinterName は、更新するプリンターの名前を指します。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | winddiui.h (Winddiui.h を含む) |