Fonction TmPrePrepareComplete (wdm.h)

Article
03/01/2024

La routine TmPrePrepareComplete informe KTM que le gestionnaire de ressources appelant a terminé la préparation préliminaire des données d’une transaction.

Syntaxe

NTSTATUS TmPrePrepareComplete(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

Paramètres

[in] Enlistment

Pointeur vers un objet d’inscription. Votre composant peut recevoir ce pointeur en tant qu’entrée dans une routine de rappel ResourceManagerNotification . Votre composant peut également appeler ObReferenceObjectByHandle et fournir le handle d’objet fourni par un appel précédent à ZwCreateEnlistment, TmCreateEnlistment ou ZwOpenEnlistment .

[in] TmVirtualClock

Pointeur vers une valeur d’horloge virtuelle. Ce paramètre est facultatif et peut être NULL.

Valeur retournée

TmPrePrepareComplete retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette routine peut retourner l’une des valeurs suivantes :

Code de retour	Description
STATUS_TRANSACTION_NOT_REQUESTED	La transaction ou son inscription n’est pas dans l’état correct. Par exemple, KTM n’a pas envoyé de notification TRANSACTION_NOTIFY_PREPARE.

La routine peut retourner d’autres valeurs NTSTATUS.

Remarques

La routine TmPrePrepareComplete est une version basée sur un pointeur de la routine ZwPrePrepareComplete .

Pour plus d’informations sur l’utilisation des routines TmXxx de KTM au lieu des routines ZwXxx , consultez Utilisation des routines TmXxx.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures du système d’exploitation.
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL