DrvDriverEvent 関数 (winddiui.h)

印刷スプーラーは、スプーラーがプリンター ドライバーによる操作を必要とする可能性があるドライバー固有のイベントを処理するときに、プリンター インターフェイス DLL の DrvDriverEvent 関数を呼び出します。

構文

BOOL DrvDriverEvent(
                 DWORD  dwDriverEvent,
                 DWORD  dwLevel,
  [in, optional] LPBYTE pDriverInfo,
                 LPARAM lParam
);

パラメーター

dwDriverEvent

発生したイベントを示す呼び出し元指定のビット フラグ。 有効なフラグを次の表に示します。

フラグ	定義
DRIVER_EVENT_DELETE	ドライバーが削除されています。
DRIVER_EVENT_INITIALIZE	ドライバーがインストールされました。

dwLevel

次の表に示すように、 pDriverInfo パラメーターによって指される構造体の種類を示す呼び出し元から指定された値。

dwLevel 値	pDriverInfo によって指される構造体
1	DRIVER_INFO_1
2	DRIVER_INFO_2
3	DRIVER_INFO_3

DRIVER_INFO_N 構造体については、Microsoft Windows SDKドキュメントを参照してください。

[in, optional] pDriverInfo

dwLevel パラメーターによって型が識別される構造体への呼び出し元指定のポインター。

lParam

呼び出し元が指定したフラグ。 次の「解説」セクションを参照してください。

戻り値

操作が成功した場合、関数は TRUE を返す必要があります。 それ以外の場合は、 FALSE を返す必要があります。

注釈

オプションの DrvDriverEvent 関数は、スプーラーの AddPrinterDriverEx 関数と DeletePrinterDriverEx 関数によって呼び出されます。これは、Windows SDKドキュメントで説明されています。

この関数の目的は、ドライバーがインストールまたは削除されたときに必要な操作を 、プリンター ドライバーのプリンター インターフェイス DLL で実行できるようにすることです。 この関数が実行する一般的な操作は、 プリンター INF ファイルで依存ファイルとして指定されていないドライバー固有の追加ファイルを作成または削除することです。

dwDriverEvent がDRIVER_EVENT_DELETEされている場合、lparam パラメーターには、DeletePrinterDriverEx 関数の dwDeleteFlag パラメーターに指定されたフラグが含まれます。 dwDriverEvent がDRIVER_EVENT_INITIALIZE場合、lparam パラメーターは使用されません。

DrvDriverEvent 関数は印刷スプーラーのコンテキストで呼び出されるため、ユーザー インターフェイスを表示できません。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	winddiui.h (Winddiui.h を含む)