DRIVERPROC

コールバック

シグネチャ

LRESULT DRIVERPROC(
    UINT_PTR param0,
    HDRVR param1,
    DWORD param2,
    LPARAM param3,
    LPARAM param4
);

パラメーター

フィールド

型

説明

param0

UINT_PTR

インストール可能ドライバーの識別子です。

param1

HDRVR

インストール可能ドライバーのインスタンスのハンドルです。インストール可能ドライバーの各インスタンスは一意のハンドルを持ちます。

param2

DWORD

ドライバーメッセージの値です。カスタム値、または次の標準値のいずれかを指定できます:

値	意味
DRV_CLOSE	使用カウントを 1 減らし、カウントが 0 になった場合はドライバーをアンロードする必要があることをドライバーに通知します。
DRV_CONFIGURE	構成ダイアログボックスを表示する必要があることをドライバーに通知します。このメッセージは、ドライバーが DRV_QUERYCONFIGURE メッセージの処理時に 0 以外の値を返した場合にのみ送信されます。
DRV_DISABLE	割り当てられているメモリがまもなく解放されることをドライバーに通知します。
DRV_ENABLE	ドライバーが読み込まれたか再読み込みされたこと、または Windows が有効になったことをドライバーに通知します。
DRV_FREE	ドライバーが破棄されることをドライバーに通知します。
DRV_INSTALL	ドライバーが正常にインストールされたことをドライバーに通知します。
DRV_LOAD	ドライバーが正常に読み込まれたことをドライバーに通知します。
DRV_OPEN	ドライバーがまもなく開かれることをドライバーに通知します。
DRV_POWER	デバイスの電源がまもなくオンまたはオフになることをドライバーに通知します。
DRV_QUERYCONFIGURE	DRV_CONFIGURE メッセージをサポートするかどうかを示すようドライバーに指示します。
DRV_REMOVE	ドライバーがまもなくシステムから削除されることをドライバーに通知します。

param3

LPARAM

メッセージ固有の 32 ビット値です。

param4

LPARAM

メッセージ固有の 32 ビット値です。

公式ドキュメント

インストール可能ドライバーのドライバーメッセージを処理します。DriverProc はドライバーが提供する関数です。

戻り値

成功した場合は 0 以外の値を返し、それ以外の場合は 0 を返します。

解説(Remarks)

msg が DRV_OPEN の場合、lParam1 は SYSTEM.INI ファイル内のドライバーファイル名に続く文字列であり、lParam2 は OpenDriver 関数の呼び出しで lParam パラメーターとして指定された値です。

msg が DRV_CLOSE の場合、lParam1 と lParam2 は CloseDriver 関数の呼び出しにおける lParam1 および lParam2 パラメーターと同じ値です。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)