Função TmEnableCallbacks (wdm.h)

A rotina TmEnableCallbacks permite uma rotina de retorno de chamada que recebe notificações de transação.

Sintaxe

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

Parâmetros

[in] ResourceManager

Um ponteiro para um objeto do gerenciador de recursos. Para obter esse ponteiro, seu componente deve chamar ObReferenceObjectByHandle e fornecer o identificador de objeto que uma chamada anterior para ZwCreateResourceManager ou ZwOpenResourceManager forneceu.

[in] CallbackRoutine

Um ponteiro para uma rotina ResourceManagerNotification .

[in, optional] RMKey

Um valor de contexto definido pelo chamador que identifica exclusivamente o gerenciador de recursos. A rotina ResourceManagerNotification do chamador recebe esse valor como entrada.

Retornar valor

TmEnableCallbacks retorna STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina pode retornar o seguinte valor:

Código de retorno	Descrição
STATUS_UNSUCCESSFUL	O ponteiro CallbackRoutine é NULL.

 

A rotina pode retornar outros valores NTSTATUS.

Comentários

O gerenciador de recursos pode chamar TmEnableCallbacks para habilitar uma rotina de retorno de chamada ResourceManagerNotification . Use TmEnableCallbacks para habilitar notificações assíncronas. Use ZwGetNotificationResourceManager para obter notificações de forma síncrona.

Os gerenciadores de recursos podem registrar uma rotina de retorno de chamada para cada objeto do gerenciador de recursos.

Para obter mais informações sobre a rotina TmEnableCallbacks, consulte Criando um Resource Manager.

Para obter informações sobre quando usar rotinas TmXxx da KTM em vez de rotinas ZwXxx , consulte Usando rotinas TmXxx.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores do sistema operacional.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Confira também

ObReferenceObjectByHandle

ResourceManagerNotification

ZwCreateResourceManager

ZwGetNotificationResourceManager

ZwOpenResourceManager