TmEnableCallbacks-Funktion (wdm.h)

Die TmEnableCallbacks-Routine ermöglicht eine Rückrufroutine, die Transaktionsbenachrichtigungen empfängt.

Syntax

NTSTATUS TmEnableCallbacks(
  [in]           PKRESOURCEMANAGER   ResourceManager,
  [in]           PTM_RM_NOTIFICATION CallbackRoutine,
  [in, optional] PVOID               RMKey
);

Parameter

[in] ResourceManager

Ein Zeiger auf ein Resource Manager-Objekt. Um diesen Zeiger zu erhalten, muss Ihre Komponente ObReferenceObjectByHandle aufrufen und das Objekthandle bereitstellen, das ein vorheriger Aufruf von ZwCreateResourceManager oder ZwOpenResourceManager bereitgestellt hat.

[in] CallbackRoutine

Ein Zeiger auf eine ResourceManagerNotification-Routine .

[in, optional] RMKey

Ein vom Aufrufer definierter Kontextwert, der den Ressourcen-Manager eindeutig identifiziert. Die ResourceManagerNotification-Routine des Aufrufers empfängt diesen Wert als Eingabe.

Rückgabewert

TmEnableCallbacks gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine möglicherweise den folgenden Wert zurück:

Rückgabecode	Beschreibung
STATUS_UNSUCCESSFUL	Der CallbackRoutine-Zeiger ist NULL.

 

Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.

Hinweise

Ihr Ressourcen-Manager kann TmEnableCallbacks aufrufen, um eine ResourceManagerNotification-Rückrufroutine zu aktivieren. Verwenden Sie TmEnableCallbacks , um asynchrone Benachrichtigungen zu aktivieren. Verwenden Sie ZwGetNotificationResourceManager , um Benachrichtigungen synchron abzurufen.

Ressourcen-Manager können eine Rückrufroutine für jedes Resource Manager-Objekt registrieren.

Weitere Informationen zur TmEnableCallbacks-Routine finden Sie unter Erstellen einer Resource Manager.

Informationen dazu, wann die TmXxx-Routinen von KTM anstelle von ZwXxx-Routinen verwendet werden sollen, finden Sie unter Verwenden von TmXxx-Routinen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Weitere Informationen

ObReferenceObjectByHandle

ResourceManagerNotification

ZwCreateResourceManager

ZwGetNotificationResourceManager

ZwOpenResourceManager