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

Vedi anche

ObReferenceObjectByHandle

ResourceManagerNotification

ZwCreateResourceManager

ZwGetNotificationResourceManager

ZwOpenResourceManager