TmEnableCallbacks 函式 (wdm.h)
TmEnableCallbacks 例程會啟用接收交易通知的回呼例程。
語法
NTSTATUS TmEnableCallbacks(
[in] PKRESOURCEMANAGER ResourceManager,
[in] PTM_RM_NOTIFICATION CallbackRoutine,
[in, optional] PVOID RMKey
);
參數
[in] ResourceManager
Resource Manager 物件的指標。 若要取得此指標,您的元件必須呼叫 ObReferenceObjectByHandle ,並提供先前呼叫 ZwCreateResourceManager 或 ZwOpenResourceManager 的物件句柄。
[in] CallbackRoutine
ResourceManagerNotification 例程的指標。
[in, optional] RMKey
可唯一識別資源管理員的呼叫端定義內容值。 呼叫端的 ResourceManagerNotification 例程會接收此值作為輸入。
傳回值
如果作業成功,TmEnableCallbacks 會傳回STATUS_SUCCESS。 否則,此例程可能會傳回下列值:
傳回碼 | Description |
---|---|
|
CallbackRoutine指標為 NULL。 |
例程可能會傳回其他 NTSTATUS值。
備註
您的資源管理員可以呼叫 TmEnableCallbacks 來啟用 ResourceManagerNotification 回呼 例程。 使用 TmEnableCallbacks 來啟用異步通知。 使用 ZwGetNotificationResourceManager 以同步方式取得通知。
資源管理員可以為每個 Resource Manager 物件註冊一個回呼例程。
如需TmEnableCallbacks例程的詳細資訊,請參閱建立 Resource Manager。
如需何時使用 KTM 的 TmXxx 例程而非 Zw Xxx 例程的資訊,請參閱使用 TmXxx例程。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows Vista 和更新版本的作業系統版本。 |
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |