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:

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

Confira também

ObReferenceObjectByHandle

ResourceManagerNotification

ZwCreateResourceManager

ZwGetNotificationResourceManager

ZwOpenResourceManager