Funzione TmEnableCallbacks (wdm.h)
La routine TmEnableCallbacks abilita una routine di callback che riceve le notifiche delle transazioni.
Sintassi
NTSTATUS TmEnableCallbacks(
[in] PKRESOURCEMANAGER ResourceManager,
[in] PTM_RM_NOTIFICATION CallbackRoutine,
[in, optional] PVOID RMKey
);
Parametri
[in] ResourceManager
Puntatore a un oggetto resource manager. Per ottenere questo puntatore, il componente deve chiamare ObReferenceObjectByHandle e fornire l'handle dell'oggetto fornito da una chiamata precedente a ZwCreateResourceManager o ZwOpenResourceManager .
[in] CallbackRoutine
Puntatore a una routine ResourceManagerNotification .
[in, optional] RMKey
Valore di contesto definito dal chiamante che identifica in modo univoco il gestore risorse. La routine ResourceManagerNotification del chiamante riceve questo valore come input.
Valore restituito
TmEnableCallbacks restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire il valore seguente:
Codice restituito | Descrizione |
---|---|
|
Il puntatore CallbackRoutine è NULL. |
La routine potrebbe restituire altri valori NTSTATUS.
Commenti
Il gestore risorse può chiamare TmEnableCallbacks per abilitare una routine di callback ResourceManagerNotification . Usare TmEnableCallbacks per abilitare le notifiche asincrone. Usare ZwGetNotificationResourceManager per ottenere le notifiche in modo sincrono.
I gestori di risorse possono registrare una routine di callback per ogni oggetto resource manager.
Per altre informazioni sulla routine TmEnableCallbacks, vedere Creazione di un Resource Manager.
Per informazioni su quando usare le routine TmXxx di KTM anziché le routine ZwXxx , vedere Using TmXxx Routines (Uso delle routine TmXxx).
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile in Windows Vista e versioni successive del sistema operativo. |
Piattaforma di destinazione | Universale |
Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
Libreria | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |