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を返します。 それ以外の場合、このルーチンは次の値を返す可能性があります。

ルーチンは、他の NTSTATUS 値を返す場合があります。

注釈

リソース マネージャーは TmEnableCallbacks を呼び出して、 ResourceManagerNotification コールバック ルーチンを有効にすることができます。 TmEnableCallbacks を使用して非同期通知を有効にします。 通知を同期的に取得するには、 ZwGetNotificationResourceManager を使用します。

リソース マネージャーは、リソース マネージャー オブジェクトごとに 1 つのコールバック ルーチンを登録できます。

TmEnableCallbacks ルーチンの詳細については、「Resource Managerの作成」を参照してください。

Zw Xxx ルーチンの代わりに KTM の TmXxx ルーチンを使用する場合の詳細については、「TmXxx ルーチンの使用」を参照してください。

要件

こちらもご覧ください

ObReferenceObjectByHandle

ResourceManagerNotification

ZwCreateResourceManager

ZwGetNotificationResourceManager

ZwOpenResourceManager