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 を含む) |