CmRegisterCallback 関数 (wdm.h)
CmRegisterCallback ルーチンは、Windows Vista 以降のオペレーティング システム バージョンでは使用されなくなりました。 代わりに CmRegisterCallbackEx を使用してください。
CmRegisterCallback ルーチンは RegistryCallback ルーチンを登録します。
構文
NTSTATUS CmRegisterCallback(
[in] PEX_CALLBACK_FUNCTION Function,
[in, optional] PVOID Context,
[out] PLARGE_INTEGER Cookie
);
パラメーター
[in] Function
登録する RegistryCallback ルーチンへのポインター。
[in, optional] Context
構成マネージャーが CallbackContext パラメーターとして RegistryCallback ルーチンに渡すドライバー定義値
[out] Cookie
コールバック ルーチンを識別する値を受け取るLARGE_INTEGER変数へのポインター。 コールバック ルーチンの登録を解除するときに、この値を Cookie パラメーターとして CmUnRegisterCallback に渡します。
戻り値
CmRegisterCallback は、操作が成功した場合はSTATUS_SUCCESSを返し、失敗した場合は適切な NTSTATUS エラー コードを返します。
注釈
CmRegisterCallback ルーチンは、Windows XP 以降のオペレーティング システム バージョンで使用できます。 Windows Vista 以降のオペレーティング システムバージョンの場合は、代わりに CmRegisterCallbackEx を使用する必要があります。
ドライバーは CmRegisterCallback を呼び出して RegistryCallback ルーチンを登録します。これは、スレッドがレジストリに対して操作を実行するたびに呼び出されます。
CmUnRegisterCallback を呼び出して、CmRegisterCallback が登録したコールバック ルーチンの登録を解除します。
CmRegisterCallback とレジストリ操作のフィルター処理の詳細については、「レジストリ呼び出しのフィルター処理」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <=APC_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), IrqlExApcLte2(wdm) |