REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION 構造体 (wdm.h)

  • [アーティクル]

REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION構造体には、ドライバーの RegistryCallback ルーチンが、以前にレジストリ オブジェクトに関連付けられているコンテキストに割り当てられたリソースを解放するために使用できる情報が含まれています。

構文

typedef struct _REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION {
  PVOID Object;
  PVOID ObjectContext;
  PVOID Reserved;
} REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION, *PREG_CALLBACK_CONTEXT_CLEANUP_INFORMATION;

メンバー

Object

削除するキーのレジストリ キー オブジェクトへのポインター。

ObjectContext

CmSetCallbackObjectContext を呼び出すことによって、ドライバーがレジストリ オブジェクトに関連付けたドライバー定義のコンテキスト情報へのポインター。

Reserved

このメンバーは将来使用するために予約されています。

注釈

この構造体は、 RegistryCallback ルーチンによって使用されます。 RegistryCallback ルーチンの Argument1 パラメーターが RegNtCallbackObjectContextCleanup の場合、Argument2 パラメーターはREG_CALLBACK_CONTEXT_CLEANUP_INFORMATION構造体へのポインターです。

ドライバーの RegistryCallback ルーチンは、キー オブジェクトの参照カウントが 0 に低下したときに RegNtCallbackObjectContextCleanup 通知を受け取ります (つまり、キー オブジェクトへの未処理のハンドルやポインター参照はありません)。

この通知に応答して、ルーチンは、オブジェクトのコンテキストに割り当てられたすべてのリソースを解放する必要があります。 RegNtCallbackObjectContextCleanup 通知は、ドライバーが CmUnRegisterCallback を呼び出したか、ドライバーの RegistryCallback ルーチンが RegNtPreKeyHandleClose 通知の処理を完了したばかりの場合に発生します。

レジストリのフィルター処理操作の詳細については、「レジストリ 呼び出しのフィルター処理」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista 以降で使用できます。
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)

こちらもご覧ください

CmSetCallbackObjectContext

CmUnRegisterCallback

RegistryCallback