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)

こちらもご覧ください

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback