Función TmEnableCallbacks (wdm.h)

La rutina TmEnableCallbacks habilita una rutina de devolución de llamada que recibe notificaciones de transacción.

Sintaxis

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

Parámetros

[in] ResourceManager

Puntero a un objeto de Resource Manager. Para obtener este puntero, el componente debe llamar a ObReferenceObjectByHandle y proporcionar el identificador del objeto que proporcionó una llamada anterior a ZwCreateResourceManager o ZwOpenResourceManager .

[in] CallbackRoutine

Puntero a una rutina ResourceManagerNotification .

[in, optional] RMKey

Valor de contexto definido por el autor de la llamada que identifica de forma única el administrador de recursos. La rutina ResourceManagerNotification del autor de la llamada recibe este valor como entrada.

Valor devuelto

TmEnableCallbacks devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver el siguiente valor:

Código devuelto	Descripción
STATUS_UNSUCCESSFUL	El puntero CallbackRoutine es NULL.

 

La rutina podría devolver otros valores NTSTATUS.

Comentarios

El administrador de recursos puede llamar a TmEnableCallbacks para habilitar una rutina de devolución de llamada ResourceManagerNotification . Use TmEnableCallbacks para habilitar las notificaciones asincrónicas. Use ZwGetNotificationResourceManager para obtener notificaciones de forma sincrónica.

Los administradores de recursos pueden registrar una rutina de devolución de llamada para cada objeto de Resource Manager.

Para obtener más información sobre la rutina TmEnableCallbacks, vea Creating a Resource Manager.

Para obtener información sobre cuándo usar rutinas TmXxx de KTM en lugar de rutinas ZwXxx , vea Using TmXxx Routines.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores del sistema operativo.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Consulte también

ObReferenceObjectByHandle

ResourceManagerNotification

ZwCreateResourceManager

ZwGetNotificationResourceManager

ZwOpenResourceManager