TmEnableCallbacks, fonction (wdm.h)
La routine TmEnableCallbacks active une routine de rappel qui reçoit des notifications de transaction.
Syntaxe
NTSTATUS TmEnableCallbacks(
[in] PKRESOURCEMANAGER ResourceManager,
[in] PTM_RM_NOTIFICATION CallbackRoutine,
[in, optional] PVOID RMKey
);
Paramètres
[in] ResourceManager
Pointeur vers un objet Resource Manager. Pour obtenir ce pointeur, votre composant doit appeler ObReferenceObjectByHandle et fournir le handle d’objet fourni par un appel précédent à ZwCreateResourceManager ou ZwOpenResourceManager .
[in] CallbackRoutine
Pointeur vers une routine ResourceManagerNotification .
[in, optional] RMKey
Valeur de contexte définie par l’appelant qui identifie de manière unique le gestionnaire de ressources. La routine ResourceManagerNotification de l’appelant reçoit cette valeur en tant qu’entrée.
Valeur retournée
TmEnableCallbacks retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette routine peut retourner la valeur suivante :
| Code de retour | Description |
|---|---|
|
Le pointeur CallbackRoutine est NULL. |
La routine peut retourner d’autres valeurs NTSTATUS.
Remarques
Votre gestionnaire de ressources peut appeler TmEnableCallbacks pour activer une routine de rappel ResourceManagerNotification . Utilisez TmEnableCallbacks pour activer les notifications asynchrones . Utilisez ZwGetNotificationResourceManager pour obtenir des notifications de manière synchrone.
Les gestionnaires de ressources peuvent inscrire une routine de rappel pour chaque objet Resource Manager.
Pour plus d’informations sur la routine TmEnableCallbacks, consultez Création d’un Resource Manager.
Pour plus d’informations sur l’utilisation des routines TmXxx de KTM au lieu des routines ZwXxx , consultez Utilisation des routines TmXxx.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et versions ultérieures du système d’exploitation. |
| Plateforme cible | Universal |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |