TmEnableCallbacks 関数 (wdm.h)
TmEnableCallbacks ルーチンは、トランザクション通知を受信するコールバック ルーチンを有効にします。
構文
NTSTATUS TmEnableCallbacks(
[in] PKRESOURCEMANAGER ResourceManager,
[in] PTM_RM_NOTIFICATION CallbackRoutine,
[in, optional] PVOID RMKey
);
パラメーター
[in] ResourceManager
リソース マネージャー オブジェクトへのポインター。 このポインターを取得するには、コンポーネントで ObReferenceObjectByHandle を呼び出し、 前に ZwCreateResourceManager または ZwOpenResourceManager を呼び出したオブジェクト ハンドルを指定する必要があります。
[in] CallbackRoutine
ResourceManagerNotification ルーチンへのポインター。
[in, optional] RMKey
リソース マネージャーを一意に識別する呼び出し元定義のコンテキスト値。 呼び出し元の ResourceManagerNotification ルーチンは、この値を入力として受け取ります。
戻り値
TmEnableCallbacks は、 操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、このルーチンは次の値を返す可能性があります。
リターン コード | 説明 |
---|---|
|
CallbackRoutine ポインターが NULL です。 |
ルーチンは、他の NTSTATUS 値を返す場合があります。
注釈
リソース マネージャーは TmEnableCallbacks を呼び出して、 ResourceManagerNotification コールバック ルーチンを有効にすることができます。 TmEnableCallbacks を使用して非同期通知を有効にします。 通知を同期的に取得するには、 ZwGetNotificationResourceManager を使用します。
リソース マネージャーは、リソース マネージャー オブジェクトごとに 1 つのコールバック ルーチンを登録できます。
TmEnableCallbacks ルーチンの詳細については、「Resource Managerの作成」を参照してください。
Zw Xxx ルーチンの代わりに KTM の TmXxx ルーチンを使用する場合の詳細については、「TmXxx ルーチンの使用」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista 以降のオペレーティング システム バージョンで使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
Library | NtosKrnl.lib |
[DLL] | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |