REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION-Struktur (wdm.h)

  • Artikel

Die REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION-Struktur enthält Informationen, die die RegistryCallback-Routine eines Treibers verwenden kann, um Ressourcen freizugeben, die der Treiber zuvor für den Kontext zugewiesen hat, der einem Registrierungsobjekt zugeordnet ist.

Syntax

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

Member

Object

Ein Zeiger auf das Registrierungsschlüsselobjekt für den zu löschenden Schlüssel.

ObjectContext

Ein Zeiger auf vom Treiber definierte Kontextinformationen, die der Treiber einem Registrierungsobjekt zugeordnet hat, indem CmSetCallbackObjectContext aufgerufen wird.

Reserved

Dieses Element ist für die zukünftige Verwendung reserviert.

Hinweise

Diese Struktur wird von der RegistryCallback-Routine verwendet. Wenn der Argument1-Parameter für die RegistryCallback-RoutineRegNtCallbackObjectContextCleanup ist, ist der Parameter Argument2 ein Zeiger auf eine REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION-Struktur .

Die RegistryCallback-Routine des Treibers erhält eine RegNtCallbackObjectContextCleanup-Benachrichtigung , wenn die Verweisanzahl des Schlüsselobjekts auf 0 (d. h. es gibt keine ausstehenden Handles oder Zeigerverweise auf das Schlüsselobjekt).

Als Reaktion auf diese Benachrichtigung sollte die Routine alle Ressourcen freigeben, die sie für den Kontext des Objekts zugewiesen hat. Die RegNtCallbackObjectContextCleanup-Benachrichtigung tritt auf, wenn der Treiber CmUnRegisterCallback aufgerufen hat oder die RegistryCallback-Routine des Treibers gerade die Verarbeitung einer RegNtPreKeyHandleClose-Benachrichtigung abgeschlossen hat.

Weitere Informationen zu Registrierungsfiltervorgängen finden Sie unter Filtern von Registrierungsaufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows Vista.
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

CmSetCallbackObjectContext

CmUnRegisterCallback

RegistryCallback