PTM_RM_NOTIFICATION コールバック関数 (wdm.h)

[アーティクル]
02/07/2025

リソースマネージャーの ResourceManagerNotification コールバックルーチンは、トランザクション通知を受信して処理します。

構文

PTM_RM_NOTIFICATION PtmRmNotification;

NTSTATUS PtmRmNotification(
  [in]      PKENLISTMENT EnlistmentObject,
  [in]      PVOID RMContext,
  [in]      PVOID TransactionContext,
  [in]      ULONG TransactionNotification,
  [in, out] PLARGE_INTEGER TmVirtualClock,
  [in]      ULONG ArgumentLength,
  [in]      PVOID Argument
)
{...}

パラメーター

[in] EnlistmentObject

参加オブジェクトへのポインター。 ResourceManagerNotification コールバックルーチンは、このオブジェクトが表す参加の通知を受け取っています。

[in] RMContext

TmEnableCallbacks ルーチンの RMKey パラメーターに対してリソースマネージャーが以前に指定した値。

[in] TransactionContext

ZwCreateEnlistment ルーチンの EnlistmentKey パラメーターに対してリソースマネージャーが以前に指定した値。

[in] TransactionNotification

Ktmtypes.h で定義されているTRANSACTION_NOTIFY_XXX 値の 1 つ。この値は、KTM が呼び出し元に送信したトランザクション通知の種類を指定します。

[in, out] TmVirtualClock

KTM がリソースマネージャーへの配信の通知を準備した時点で仮想クロック値を含む場所へのポインター。コールバックルーチンが戻る前にこの値を増やすと、KTM は仮想クロックを新しい値に更新します。 (通常、リソースマネージャーは仮想クロック値を変更しません)。

[in] ArgumentLength

引数パラメーターが指すバッファーの長さ (バイト単位)。バッファーが使用できない場合、このパラメーターは 0 です。

[in] Argument

通知固有の引数を含むバッファーへのポインター。 TransactionNotification パラメーターで指定された通知に引数バッファーが必要ない場合、このパラメーターは NULL 。

追加の引数バッファーを含む通知の一覧については、TRANSACTION_NOTIFICATIONの「解説」セクションを参照してください。

戻り値

ResourceManagerNotification コールバックルーチンは、操作が成功した場合、NT_SUCCESS(状態) が TRUE 等しいSTATUS_SUCCESSまたは別のステータス値を返す必要があります。

通常、リソースマネージャーは通知を同期的に処理する場合はSTATUS_SUCCESSを返し、通知を非同期的に処理する場合はSTATUS_PENDINGしますが、どちらの場合もSTATUS_PENDINGを返すことができます。ただし、リソースマネージャーは、TmXxxComplete または ZwXxxComplete ルーチンのいずれかを呼び出すことによって応答する通知に対してのみ、STATUS_PENDINGを返すことができます。

つまり、リソースマネージャーが、TmXxxComplete または ZwXxxComplete ルーチンのいずれかを呼び出して通知に応答する必要がある場合、通知のSTATUS_PENDINGを返し、後で適切な TmXxxComplete または ZwXxxComplete ルーチンを呼び出すことができます。

エラーが発生した場合、コールバックルーチンは、NT_SUCCESS(status) が FALSE 等しい状態値を返す必要があります。

備考

ResourceManagerNotification コールバックルーチンを登録するには、リソースマネージャーが TmEnableCallbacks 呼び出す必要があります。

ResourceManagerNotification コールバックルーチンは、ハンドルではなく、参加オブジェクトへのポインターを受け取ります。参加オブジェクトポインターを、参加オブジェクトの tmXxx ルーチン渡すことができます。

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

ResourceManagerNotification コールバックルーチンは IRQL = PASSIVE_LEVEL で呼び出され、IRQL = PASSIVE_LEVEL で返される必要があります。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista 以降のオペレーティングシステムバージョンで使用できます。
ターゲットプラットフォームの	デスクトップ
ヘッダー	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
IRQL	PASSIVE_LEVEL (「解説」セクションを参照)

次の方法で共有

PTM_RM_NOTIFICATION コールバック関数 (wdm.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース