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 |
|---|---|
|
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 |