nttmapi.h File Reference

#include <ktmtypes.h>

Include dependency graph for nttmapi.h:

Go to the source code of this file.

Classes
struct	_TRANSACTION_BASIC_INFORMATION
struct	_TRANSACTIONMANAGER_BASIC_INFORMATION
struct	_TRANSACTIONMANAGER_LOG_INFORMATION
struct	_TRANSACTIONMANAGER_LOGPATH_INFORMATION
struct	_TRANSACTIONMANAGER_RECOVERY_INFORMATION
struct	_TRANSACTION_PROPERTIES_INFORMATION
struct	_TRANSACTION_BIND_INFORMATION
struct	_TRANSACTION_ENLISTMENT_PAIR
struct	_TRANSACTION_ENLISTMENTS_INFORMATION
struct	_TRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION
struct	_RESOURCEMANAGER_BASIC_INFORMATION
struct	_RESOURCEMANAGER_COMPLETION_INFORMATION
struct	_KTMOBJECT_CURSOR
struct	_ENLISTMENT_BASIC_INFORMATION
struct	_ENLISTMENT_CRM_INFORMATION
struct	_TRANSACTION_LIST_ENTRY
struct	_TRANSACTION_LIST_INFORMATION

Macros
#define	TRANSACTIONMANAGER_QUERY_INFORMATION   (0x0001)
#define	TRANSACTIONMANAGER_SET_INFORMATION   (0x0002)
#define	TRANSACTIONMANAGER_RECOVER   (0x0004)
#define	TRANSACTIONMANAGER_RENAME   (0x0008)
#define	TRANSACTIONMANAGER_CREATE_RM   (0x0010)
#define	TRANSACTIONMANAGER_BIND_TRANSACTION   (0x0020)
#define	TRANSACTIONMANAGER_GENERIC_READ
#define	TRANSACTIONMANAGER_GENERIC_WRITE
#define	TRANSACTIONMANAGER_GENERIC_EXECUTE   (STANDARD_RIGHTS_EXECUTE)
#define	TRANSACTIONMANAGER_ALL_ACCESS
#define	TRANSACTION_QUERY_INFORMATION   (0x0001)
#define	TRANSACTION_SET_INFORMATION   (0x0002)
#define	TRANSACTION_ENLIST   (0x0004)
#define	TRANSACTION_COMMIT   (0x0008)
#define	TRANSACTION_ROLLBACK   (0x0010)
#define	TRANSACTION_PROPAGATE   (0x0020)
#define	TRANSACTION_RIGHT_RESERVED1   (0x0040)
#define	TRANSACTION_GENERIC_READ
#define	TRANSACTION_GENERIC_WRITE
#define	TRANSACTION_GENERIC_EXECUTE
#define	TRANSACTION_ALL_ACCESS
#define	TRANSACTION_RESOURCE_MANAGER_RIGHTS
#define	RESOURCEMANAGER_QUERY_INFORMATION   (0x0001)
#define	RESOURCEMANAGER_SET_INFORMATION   (0x0002)
#define	RESOURCEMANAGER_RECOVER   (0x0004)
#define	RESOURCEMANAGER_ENLIST   (0x0008)
#define	RESOURCEMANAGER_GET_NOTIFICATION   (0x0010)
#define	RESOURCEMANAGER_REGISTER_PROTOCOL   (0x0020)
#define	RESOURCEMANAGER_COMPLETE_PROPAGATION   (0x0040)
#define	RESOURCEMANAGER_GENERIC_READ
#define	RESOURCEMANAGER_GENERIC_WRITE
#define	RESOURCEMANAGER_GENERIC_EXECUTE
#define	RESOURCEMANAGER_ALL_ACCESS
#define	ENLISTMENT_QUERY_INFORMATION   (0x0001)
#define	ENLISTMENT_SET_INFORMATION   (0x0002)
#define	ENLISTMENT_RECOVER   (0x0004)
#define	ENLISTMENT_SUBORDINATE_RIGHTS   (0x0008)
#define	ENLISTMENT_SUPERIOR_RIGHTS   (0x0010)
#define	ENLISTMENT_GENERIC_READ
#define	ENLISTMENT_GENERIC_WRITE
#define	ENLISTMENT_GENERIC_EXECUTE
#define	ENLISTMENT_ALL_ACCESS

Typedefs
typedef enum _TRANSACTION_OUTCOME	TRANSACTION_OUTCOME
typedef enum _TRANSACTION_STATE	TRANSACTION_STATE
typedef struct _TRANSACTION_BASIC_INFORMATION	TRANSACTION_BASIC_INFORMATION
typedef struct _TRANSACTION_BASIC_INFORMATION *	PTRANSACTION_BASIC_INFORMATION
typedef struct _TRANSACTIONMANAGER_BASIC_INFORMATION	TRANSACTIONMANAGER_BASIC_INFORMATION
typedef struct _TRANSACTIONMANAGER_BASIC_INFORMATION *	PTRANSACTIONMANAGER_BASIC_INFORMATION
typedef struct _TRANSACTIONMANAGER_LOG_INFORMATION	TRANSACTIONMANAGER_LOG_INFORMATION
typedef struct _TRANSACTIONMANAGER_LOG_INFORMATION *	PTRANSACTIONMANAGER_LOG_INFORMATION
typedef struct _TRANSACTIONMANAGER_LOGPATH_INFORMATION	TRANSACTIONMANAGER_LOGPATH_INFORMATION
typedef struct _TRANSACTIONMANAGER_LOGPATH_INFORMATION *	PTRANSACTIONMANAGER_LOGPATH_INFORMATION
typedef struct _TRANSACTIONMANAGER_RECOVERY_INFORMATION	TRANSACTIONMANAGER_RECOVERY_INFORMATION
typedef struct _TRANSACTIONMANAGER_RECOVERY_INFORMATION *	PTRANSACTIONMANAGER_RECOVERY_INFORMATION
typedef struct _TRANSACTION_PROPERTIES_INFORMATION	TRANSACTION_PROPERTIES_INFORMATION
typedef struct _TRANSACTION_PROPERTIES_INFORMATION *	PTRANSACTION_PROPERTIES_INFORMATION
typedef struct _TRANSACTION_BIND_INFORMATION	TRANSACTION_BIND_INFORMATION
typedef struct _TRANSACTION_BIND_INFORMATION *	PTRANSACTION_BIND_INFORMATION
typedef struct _TRANSACTION_ENLISTMENT_PAIR	TRANSACTION_ENLISTMENT_PAIR
typedef struct _TRANSACTION_ENLISTMENT_PAIR *	PTRANSACTION_ENLISTMENT_PAIR
typedef struct _TRANSACTION_ENLISTMENTS_INFORMATION	TRANSACTION_ENLISTMENTS_INFORMATION
typedef struct _TRANSACTION_ENLISTMENTS_INFORMATION *	PTRANSACTION_ENLISTMENTS_INFORMATION
typedef struct _TRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION	TRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION
typedef struct _TRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION *	PTRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION
typedef struct _RESOURCEMANAGER_BASIC_INFORMATION	RESOURCEMANAGER_BASIC_INFORMATION
typedef struct _RESOURCEMANAGER_BASIC_INFORMATION *	PRESOURCEMANAGER_BASIC_INFORMATION
typedef struct _RESOURCEMANAGER_COMPLETION_INFORMATION	RESOURCEMANAGER_COMPLETION_INFORMATION
typedef struct _RESOURCEMANAGER_COMPLETION_INFORMATION *	PRESOURCEMANAGER_COMPLETION_INFORMATION
typedef enum _KTMOBJECT_TYPE	KTMOBJECT_TYPE
typedef enum _KTMOBJECT_TYPE *	PKTMOBJECT_TYPE
typedef struct _KTMOBJECT_CURSOR	KTMOBJECT_CURSOR
typedef struct _KTMOBJECT_CURSOR *	PKTMOBJECT_CURSOR
typedef enum _TRANSACTION_INFORMATION_CLASS	TRANSACTION_INFORMATION_CLASS
typedef enum _TRANSACTIONMANAGER_INFORMATION_CLASS	TRANSACTIONMANAGER_INFORMATION_CLASS
typedef enum _RESOURCEMANAGER_INFORMATION_CLASS	RESOURCEMANAGER_INFORMATION_CLASS
typedef struct _ENLISTMENT_BASIC_INFORMATION	ENLISTMENT_BASIC_INFORMATION
typedef struct _ENLISTMENT_BASIC_INFORMATION *	PENLISTMENT_BASIC_INFORMATION
typedef struct _ENLISTMENT_CRM_INFORMATION	ENLISTMENT_CRM_INFORMATION
typedef struct _ENLISTMENT_CRM_INFORMATION *	PENLISTMENT_CRM_INFORMATION
typedef enum _ENLISTMENT_INFORMATION_CLASS	ENLISTMENT_INFORMATION_CLASS
typedef struct _TRANSACTION_LIST_ENTRY	TRANSACTION_LIST_ENTRY
typedef struct _TRANSACTION_LIST_ENTRY *	PTRANSACTION_LIST_ENTRY
typedef struct _TRANSACTION_LIST_INFORMATION	TRANSACTION_LIST_INFORMATION
typedef struct _TRANSACTION_LIST_INFORMATION *	PTRANSACTION_LIST_INFORMATION
typedef NTSTATUS(NTAPI *	PFN_NT_CREATE_TRANSACTION) (_Out_ PHANDLE TransactionHandle, _In_ ACCESS_MASK DesiredAccess, _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes, _In_opt_ LPGUID Uow, _In_opt_ HANDLE TmHandle, _In_opt_ ULONG CreateOptions, _In_opt_ ULONG IsolationLevel, _In_opt_ ULONG IsolationFlags, _In_opt_ PLARGE_INTEGER Timeout, _In_opt_ PUNICODE_STRING Description)
typedef NTSTATUS(NTAPI *	PFN_NT_OPEN_TRANSACTION) (_Out_ PHANDLE TransactionHandle, _In_ ACCESS_MASK DesiredAccess, _In_ POBJECT_ATTRIBUTES ObjectAttributes, _In_opt_ LPGUID Uow, _In_opt_ HANDLE TmHandle)
typedef NTSTATUS(NTAPI *	PFN_NT_QUERY_INFORMATION_TRANSACTION) (_In_ HANDLE TransactionHandle, _In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass, _Out_writes_bytes_(TransactionInformationLength) PVOID TransactionInformation, _In_ ULONG TransactionInformationLength, _Out_opt_ PULONG ReturnLength)
typedef NTSTATUS(NTAPI *	PFN_NT_SET_INFORMATION_TRANSACTION) (_In_ HANDLE TransactionHandle, _In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass, _In_ PVOID TransactionInformation, _In_ ULONG TransactionInformationLength)
typedef NTSTATUS(NTAPI *	PFN_NT_COMMIT_TRANSACTION) (_In_ HANDLE TransactionHandle, _In_ BOOLEAN Wait)
typedef NTSTATUS(NTAPI *	PFN_NT_ROLLBACK_TRANSACTION) (_In_ HANDLE TransactionHandle, _In_ BOOLEAN Wait)

Enumerations
enum	_TRANSACTION_OUTCOME { TransactionOutcomeUndetermined = 1 , TransactionOutcomeCommitted , TransactionOutcomeAborted }
enum	_TRANSACTION_STATE { TransactionStateNormal = 1 , TransactionStateIndoubt , TransactionStateCommittedNotify }
enum	_KTMOBJECT_TYPE {   KTMOBJECT_TRANSACTION , KTMOBJECT_TRANSACTION_MANAGER , KTMOBJECT_RESOURCE_MANAGER , KTMOBJECT_ENLISTMENT ,   KTMOBJECT_INVALID }
enum	_TRANSACTION_INFORMATION_CLASS { TransactionBasicInformation , TransactionPropertiesInformation , TransactionEnlistmentInformation , TransactionSuperiorEnlistmentInformation }
enum	_TRANSACTIONMANAGER_INFORMATION_CLASS { TransactionManagerBasicInformation , TransactionManagerLogInformation , TransactionManagerLogPathInformation , TransactionManagerRecoveryInformation = 4 }
enum	_RESOURCEMANAGER_INFORMATION_CLASS { ResourceManagerBasicInformation , ResourceManagerCompletionInformation }
enum	_ENLISTMENT_INFORMATION_CLASS { EnlistmentBasicInformation , EnlistmentRecoveryInformation , EnlistmentCrmInformation }

Functions
_Must_inspect_result_	_IRQL_requires_max_ (APC_LEVEL) __kernel_entry NTSYSCALLAPI NTSTATUS NTAPI NtCreateTransactionManager(_Out_ PHANDLE TmHandle
	Probes and locks virtual pages in memory for the specified process.
_Must_inspect_result_ _In_ TRANSACTIONMANAGER_INFORMATION_CLASS	_Out_writes_bytes_ (TransactionManagerInformationLength) PVOID TransactionManagerInformation
_Must_inspect_result_ _In_ TRANSACTIONMANAGER_INFORMATION_CLASS	_In_reads_bytes_ (TransactionManagerInformationLength) PVOID TransactionManagerInformation
_Must_inspect_result_ _In_ KTMOBJECT_TYPE	_Inout_updates_bytes_ (ObjectCursorLength) PKTMOBJECT_CURSOR ObjectCursor
_Must_inspect_result_ _In_ TRANSACTION_INFORMATION_CLASS	_Out_writes_bytes_ (TransactionInformationLength) PVOID TransactionInformation
_Must_inspect_result_ _In_ TRANSACTION_INFORMATION_CLASS	_In_reads_bytes_ (TransactionInformationLength) PVOID TransactionInformation
_Must_inspect_result_ _In_ ENLISTMENT_INFORMATION_CLASS	_Out_writes_bytes_ (EnlistmentInformationLength) PVOID EnlistmentInformation
_Must_inspect_result_ _In_ ENLISTMENT_INFORMATION_CLASS	_In_reads_bytes_ (EnlistmentInformationLength) PVOID EnlistmentInformation
_Must_inspect_result_ _In_ RESOURCEMANAGER_INFORMATION_CLASS	_Out_writes_bytes_ (ResourceManagerInformationLength) PVOID ResourceManagerInformation
_Must_inspect_result_ _In_ RESOURCEMANAGER_INFORMATION_CLASS	_In_reads_bytes_ (ResourceManagerInformationLength) PVOID ResourceManagerInformation

Variables
_Must_inspect_result_ _In_ ACCESS_MASK	DesiredAccess
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES	ObjectAttributes
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ PUNICODE_STRING	LogFileName
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ PUNICODE_STRING _In_opt_ ULONG	CreateOptions
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ PUNICODE_STRING _In_opt_ ULONG _In_opt_ ULONG	CommitStrength
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ PUNICODE_STRING _In_opt_ LPGUID	TmIdentity
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ PUNICODE_STRING _In_opt_ LPGUID _In_opt_ ULONG	OpenOptions
_Must_inspect_result_ _In_ LPGUID	ExistingTransactionManagerGuid
_Must_inspect_result_ _In_opt_ PLARGE_INTEGER	TmVirtualClock
_Must_inspect_result_ _In_ TRANSACTIONMANAGER_INFORMATION_CLASS	TransactionManagerInformationClass
_Must_inspect_result_ _In_ TRANSACTIONMANAGER_INFORMATION_CLASS _In_ ULONG	TransactionManagerInformationLength
_Must_inspect_result_ _In_ TRANSACTIONMANAGER_INFORMATION_CLASS _In_ ULONG _Out_ PULONG	ReturnLength
_Must_inspect_result_ _In_ KTMOBJECT_TYPE	QueryType
_Must_inspect_result_ _In_ KTMOBJECT_TYPE _In_ ULONG	ObjectCursorLength
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ LPGUID	Uow
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ LPGUID _In_opt_ HANDLE	TmHandle
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ LPGUID _In_opt_ HANDLE _In_opt_ ULONG _In_opt_ ULONG	IsolationLevel
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ LPGUID _In_opt_ HANDLE _In_opt_ ULONG _In_opt_ ULONG _In_opt_ ULONG	IsolationFlags
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ LPGUID _In_opt_ HANDLE _In_opt_ ULONG _In_opt_ ULONG _In_opt_ ULONG _In_opt_ PLARGE_INTEGER	Timeout
_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ LPGUID _In_opt_ HANDLE _In_opt_ ULONG _In_opt_ ULONG _In_opt_ ULONG _In_opt_ PLARGE_INTEGER _In_opt_ PUNICODE_STRING	Description
_Must_inspect_result_ _In_ TRANSACTION_INFORMATION_CLASS	TransactionInformationClass
_Must_inspect_result_ _In_ TRANSACTION_INFORMATION_CLASS _In_ ULONG	TransactionInformationLength
_In_ BOOLEAN	Wait
_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE	ResourceManagerHandle
_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE _In_ HANDLE	TransactionHandle
_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE _In_ HANDLE _In_opt_ POBJECT_ATTRIBUTES _In_opt_ ULONG _In_ NOTIFICATION_MASK	NotificationMask
_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE _In_ HANDLE _In_opt_ POBJECT_ATTRIBUTES _In_opt_ ULONG _In_ NOTIFICATION_MASK _In_opt_ PVOID	EnlistmentKey
_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE _In_ LPGUID	EnlistmentGuid
_Must_inspect_result_ _In_ ENLISTMENT_INFORMATION_CLASS	EnlistmentInformationClass
_Must_inspect_result_ _In_ ENLISTMENT_INFORMATION_CLASS _In_ ULONG	EnlistmentInformationLength
_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE _In_ LPGUID	RmGuid
_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE _In_opt_ LPGUID	ResourceManagerGuid
_Must_inspect_result_ _Out_ PTRANSACTION_NOTIFICATION	TransactionNotification
_Must_inspect_result_ _Out_ PTRANSACTION_NOTIFICATION _In_ ULONG	NotificationLength
_Must_inspect_result_ _Out_ PTRANSACTION_NOTIFICATION _In_ ULONG _In_opt_ PLARGE_INTEGER _Out_opt_ PULONG _In_ ULONG	Asynchronous
_Must_inspect_result_ _Out_ PTRANSACTION_NOTIFICATION _In_ ULONG _In_opt_ PLARGE_INTEGER _Out_opt_ PULONG _In_ ULONG _In_opt_ ULONG_PTR	AsynchronousContext
_Must_inspect_result_ _In_ RESOURCEMANAGER_INFORMATION_CLASS	ResourceManagerInformationClass
_Must_inspect_result_ _In_ RESOURCEMANAGER_INFORMATION_CLASS _In_ ULONG	ResourceManagerInformationLength
_Must_inspect_result_ _In_ PCRM_PROTOCOL_ID	ProtocolId
_Must_inspect_result_ _In_ PCRM_PROTOCOL_ID _In_ ULONG	ProtocolInformationSize
_Must_inspect_result_ _In_ PCRM_PROTOCOL_ID _In_ ULONG _In_ PVOID	ProtocolInformation
_In_ ULONG	RequestCookie
_In_ ULONG _In_ ULONG	BufferLength
_In_ ULONG _In_ ULONG _In_ PVOID	Buffer
_In_ ULONG _In_ NTSTATUS	PropStatus

Macro Definition Documentation

ENLISTMENT_ALL_ACCESS

#define ENLISTMENT_ALL_ACCESS

Value:

                                        (STANDARD_RIGHTS_REQUIRED       |\
                                        ENLISTMENT_GENERIC_READ        |\
                                        ENLISTMENT_GENERIC_WRITE       |\
                                        ENLISTMENT_GENERIC_EXECUTE)

Definition at line 121 of file nttmapi.h.

ENLISTMENT_GENERIC_EXECUTE

#define ENLISTMENT_GENERIC_EXECUTE

Value:

                                        (STANDARD_RIGHTS_EXECUTE        |\
                                        ENLISTMENT_RECOVER             |\
                                        ENLISTMENT_SUBORDINATE_RIGHTS  |\
                                        ENLISTMENT_SUPERIOR_RIGHTS)

Definition at line 116 of file nttmapi.h.

ENLISTMENT_GENERIC_READ

#define ENLISTMENT_GENERIC_READ

Value:

                                        (STANDARD_RIGHTS_READ           |\
                                        ENLISTMENT_QUERY_INFORMATION)

Definition at line 107 of file nttmapi.h.

ENLISTMENT_GENERIC_WRITE

#define ENLISTMENT_GENERIC_WRITE

Value:

                                        (STANDARD_RIGHTS_WRITE          |\
                                        ENLISTMENT_SET_INFORMATION     |\
                                        ENLISTMENT_RECOVER             |\
                                        ENLISTMENT_SUBORDINATE_RIGHTS  |\
                                        ENLISTMENT_SUPERIOR_RIGHTS)

Definition at line 110 of file nttmapi.h.

ENLISTMENT_QUERY_INFORMATION

#define ENLISTMENT_QUERY_INFORMATION   (0x0001)

Definition at line 101 of file nttmapi.h.

ENLISTMENT_RECOVER

#define ENLISTMENT_RECOVER   (0x0004)

Definition at line 103 of file nttmapi.h.

ENLISTMENT_SET_INFORMATION

#define ENLISTMENT_SET_INFORMATION   (0x0002)

Definition at line 102 of file nttmapi.h.

ENLISTMENT_SUBORDINATE_RIGHTS

#define ENLISTMENT_SUBORDINATE_RIGHTS   (0x0008)

Definition at line 104 of file nttmapi.h.

ENLISTMENT_SUPERIOR_RIGHTS

#define ENLISTMENT_SUPERIOR_RIGHTS   (0x0010)

Definition at line 105 of file nttmapi.h.

RESOURCEMANAGER_ALL_ACCESS

#define RESOURCEMANAGER_ALL_ACCESS

Value:

                                             (STANDARD_RIGHTS_REQUIRED             |\
                                             RESOURCEMANAGER_GENERIC_READ         |\
                                             RESOURCEMANAGER_GENERIC_WRITE        |\
                                             RESOURCEMANAGER_GENERIC_EXECUTE)

Definition at line 96 of file nttmapi.h.

RESOURCEMANAGER_COMPLETE_PROPAGATION

#define RESOURCEMANAGER_COMPLETE_PROPAGATION   (0x0040)

Definition at line 74 of file nttmapi.h.

RESOURCEMANAGER_ENLIST

#define RESOURCEMANAGER_ENLIST   (0x0008)

Definition at line 71 of file nttmapi.h.

RESOURCEMANAGER_GENERIC_EXECUTE

#define RESOURCEMANAGER_GENERIC_EXECUTE

Value:

                                             (STANDARD_RIGHTS_EXECUTE              |\
                                             RESOURCEMANAGER_RECOVER              |\
                                             RESOURCEMANAGER_ENLIST               |\
                                             RESOURCEMANAGER_GET_NOTIFICATION     |\
                                             RESOURCEMANAGER_COMPLETE_PROPAGATION |\
                                             SYNCHRONIZE)

Definition at line 89 of file nttmapi.h.

RESOURCEMANAGER_GENERIC_READ

#define RESOURCEMANAGER_GENERIC_READ

Value:

                                             (STANDARD_RIGHTS_READ                 |\
                                             RESOURCEMANAGER_QUERY_INFORMATION    |\
                                             SYNCHRONIZE)

Definition at line 76 of file nttmapi.h.

RESOURCEMANAGER_GENERIC_WRITE

#define RESOURCEMANAGER_GENERIC_WRITE

Value:

                                             (STANDARD_RIGHTS_WRITE                |\
                                             RESOURCEMANAGER_SET_INFORMATION      |\
                                             RESOURCEMANAGER_RECOVER              |\
                                             RESOURCEMANAGER_ENLIST               |\
                                             RESOURCEMANAGER_GET_NOTIFICATION     |\
                                             RESOURCEMANAGER_REGISTER_PROTOCOL    |\
                                             RESOURCEMANAGER_COMPLETE_PROPAGATION |\
                                             SYNCHRONIZE)

Definition at line 80 of file nttmapi.h.

RESOURCEMANAGER_GET_NOTIFICATION

#define RESOURCEMANAGER_GET_NOTIFICATION   (0x0010)

Definition at line 72 of file nttmapi.h.

RESOURCEMANAGER_QUERY_INFORMATION

#define RESOURCEMANAGER_QUERY_INFORMATION   (0x0001)

Definition at line 68 of file nttmapi.h.

RESOURCEMANAGER_RECOVER

#define RESOURCEMANAGER_RECOVER   (0x0004)

Definition at line 70 of file nttmapi.h.

RESOURCEMANAGER_REGISTER_PROTOCOL

#define RESOURCEMANAGER_REGISTER_PROTOCOL   (0x0020)

Definition at line 73 of file nttmapi.h.

RESOURCEMANAGER_SET_INFORMATION

#define RESOURCEMANAGER_SET_INFORMATION   (0x0002)

Definition at line 69 of file nttmapi.h.

TRANSACTION_ALL_ACCESS

#define TRANSACTION_ALL_ACCESS

Value:

                                             (STANDARD_RIGHTS_REQUIRED        |\
                                             TRANSACTION_GENERIC_READ        |\
                                             TRANSACTION_GENERIC_WRITE       |\
                                             TRANSACTION_GENERIC_EXECUTE)

Definition at line 55 of file nttmapi.h.

TRANSACTION_COMMIT

#define TRANSACTION_COMMIT   (0x0008)

Definition at line 33 of file nttmapi.h.

TRANSACTION_ENLIST

#define TRANSACTION_ENLIST   (0x0004)

Definition at line 32 of file nttmapi.h.

TRANSACTION_GENERIC_EXECUTE

#define TRANSACTION_GENERIC_EXECUTE

Value:

                                             (STANDARD_RIGHTS_EXECUTE         |\
                                             TRANSACTION_COMMIT              |\
                                             TRANSACTION_ROLLBACK            |\
                                             SYNCHRONIZE)

Definition at line 50 of file nttmapi.h.

TRANSACTION_GENERIC_READ

#define TRANSACTION_GENERIC_READ

Value:

                                             (STANDARD_RIGHTS_READ            |\
                                             TRANSACTION_QUERY_INFORMATION   |\
                                             SYNCHRONIZE)

Definition at line 38 of file nttmapi.h.

TRANSACTION_GENERIC_WRITE

#define TRANSACTION_GENERIC_WRITE

Value:

                                             (STANDARD_RIGHTS_WRITE           |\
                                             TRANSACTION_SET_INFORMATION     |\
                                             TRANSACTION_COMMIT              |\
                                             TRANSACTION_ENLIST              |\
                                             TRANSACTION_ROLLBACK            |\
                                             TRANSACTION_PROPAGATE           |\
                                             SYNCHRONIZE)

Definition at line 42 of file nttmapi.h.

TRANSACTION_PROPAGATE

#define TRANSACTION_PROPAGATE   (0x0020)

Definition at line 35 of file nttmapi.h.

TRANSACTION_QUERY_INFORMATION

#define TRANSACTION_QUERY_INFORMATION   (0x0001)

Definition at line 30 of file nttmapi.h.

TRANSACTION_RESOURCE_MANAGER_RIGHTS

#define TRANSACTION_RESOURCE_MANAGER_RIGHTS

Value:

                                             (TRANSACTION_GENERIC_READ        |\
                                             STANDARD_RIGHTS_WRITE           |\
                                             TRANSACTION_SET_INFORMATION     |\
                                             TRANSACTION_ENLIST              |\
                                             TRANSACTION_ROLLBACK            |\
                                             TRANSACTION_PROPAGATE           |\
                                             SYNCHRONIZE)

Definition at line 60 of file nttmapi.h.

TRANSACTION_RIGHT_RESERVED1

#define TRANSACTION_RIGHT_RESERVED1   (0x0040)

Definition at line 36 of file nttmapi.h.

TRANSACTION_ROLLBACK

#define TRANSACTION_ROLLBACK   (0x0010)

Definition at line 34 of file nttmapi.h.

TRANSACTION_SET_INFORMATION

#define TRANSACTION_SET_INFORMATION   (0x0002)

Definition at line 31 of file nttmapi.h.

TRANSACTIONMANAGER_ALL_ACCESS

#define TRANSACTIONMANAGER_ALL_ACCESS

Value:

                                                    (STANDARD_RIGHTS_REQUIRED        |\
                                                    TRANSACTIONMANAGER_GENERIC_READ        |\
                                                    TRANSACTIONMANAGER_GENERIC_WRITE       |\
                                                    TRANSACTIONMANAGER_GENERIC_EXECUTE     |\
                                                    TRANSACTIONMANAGER_BIND_TRANSACTION)

Definition at line 24 of file nttmapi.h.

TRANSACTIONMANAGER_BIND_TRANSACTION

#define TRANSACTIONMANAGER_BIND_TRANSACTION   (0x0020)

Definition at line 11 of file nttmapi.h.

TRANSACTIONMANAGER_CREATE_RM

#define TRANSACTIONMANAGER_CREATE_RM   (0x0010)

Definition at line 10 of file nttmapi.h.

TRANSACTIONMANAGER_GENERIC_EXECUTE

#define TRANSACTIONMANAGER_GENERIC_EXECUTE   (STANDARD_RIGHTS_EXECUTE)

Definition at line 22 of file nttmapi.h.

TRANSACTIONMANAGER_GENERIC_READ

#define TRANSACTIONMANAGER_GENERIC_READ

Value:

                                                    (STANDARD_RIGHTS_READ            |\
                                                    TRANSACTIONMANAGER_QUERY_INFORMATION)

Definition at line 13 of file nttmapi.h.

TRANSACTIONMANAGER_GENERIC_WRITE

#define TRANSACTIONMANAGER_GENERIC_WRITE

Value:

                                                    (STANDARD_RIGHTS_WRITE           |\
                                                    TRANSACTIONMANAGER_SET_INFORMATION     |\
                                                    TRANSACTIONMANAGER_RECOVER             |\
                                                    TRANSACTIONMANAGER_RENAME              |\
                                                    TRANSACTIONMANAGER_CREATE_RM)

Definition at line 16 of file nttmapi.h.

TRANSACTIONMANAGER_QUERY_INFORMATION

#define TRANSACTIONMANAGER_QUERY_INFORMATION   (0x0001)

Definition at line 6 of file nttmapi.h.

TRANSACTIONMANAGER_RECOVER

#define TRANSACTIONMANAGER_RECOVER   (0x0004)

Definition at line 8 of file nttmapi.h.

TRANSACTIONMANAGER_RENAME

#define TRANSACTIONMANAGER_RENAME   (0x0008)

Definition at line 9 of file nttmapi.h.

TRANSACTIONMANAGER_SET_INFORMATION

#define TRANSACTIONMANAGER_SET_INFORMATION   (0x0002)

Definition at line 7 of file nttmapi.h.

Typedef Documentation

ENLISTMENT_BASIC_INFORMATION

typedef struct _ENLISTMENT_BASIC_INFORMATION ENLISTMENT_BASIC_INFORMATION

ENLISTMENT_CRM_INFORMATION

typedef struct _ENLISTMENT_CRM_INFORMATION ENLISTMENT_CRM_INFORMATION

ENLISTMENT_INFORMATION_CLASS

typedef enum _ENLISTMENT_INFORMATION_CLASS ENLISTMENT_INFORMATION_CLASS

KTMOBJECT_CURSOR

typedef struct _KTMOBJECT_CURSOR KTMOBJECT_CURSOR

KTMOBJECT_TYPE

typedef enum _KTMOBJECT_TYPE KTMOBJECT_TYPE

PENLISTMENT_BASIC_INFORMATION

typedef struct _ENLISTMENT_BASIC_INFORMATION * PENLISTMENT_BASIC_INFORMATION

PENLISTMENT_CRM_INFORMATION

typedef struct _ENLISTMENT_CRM_INFORMATION * PENLISTMENT_CRM_INFORMATION

PFN_NT_COMMIT_TRANSACTION

typedef NTSTATUS(NTAPI * PFN_NT_COMMIT_TRANSACTION) (_In_ HANDLE TransactionHandle, _In_ BOOLEAN Wait)

Definition at line 302 of file nttmapi.h.

PFN_NT_CREATE_TRANSACTION

typedef NTSTATUS(NTAPI * PFN_NT_CREATE_TRANSACTION) (_Out_ PHANDLE TransactionHandle, _In_ ACCESS_MASK DesiredAccess, _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes, _In_opt_ LPGUID Uow, _In_opt_ HANDLE TmHandle, _In_opt_ ULONG CreateOptions, _In_opt_ ULONG IsolationLevel, _In_opt_ ULONG IsolationFlags, _In_opt_ PLARGE_INTEGER Timeout, _In_opt_ PUNICODE_STRING Description)

Definition at line 266 of file nttmapi.h.

PFN_NT_OPEN_TRANSACTION

typedef NTSTATUS(NTAPI * PFN_NT_OPEN_TRANSACTION) (_Out_ PHANDLE TransactionHandle, _In_ ACCESS_MASK DesiredAccess, _In_ POBJECT_ATTRIBUTES ObjectAttributes, _In_opt_ LPGUID Uow, _In_opt_ HANDLE TmHandle)

Definition at line 279 of file nttmapi.h.

PFN_NT_QUERY_INFORMATION_TRANSACTION

typedef NTSTATUS(NTAPI * PFN_NT_QUERY_INFORMATION_TRANSACTION) (_In_ HANDLE TransactionHandle, _In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass, _Out_writes_bytes_(TransactionInformationLength) PVOID TransactionInformation, _In_ ULONG TransactionInformationLength, _Out_opt_ PULONG ReturnLength)

Definition at line 287 of file nttmapi.h.

PFN_NT_ROLLBACK_TRANSACTION

typedef NTSTATUS(NTAPI * PFN_NT_ROLLBACK_TRANSACTION) (_In_ HANDLE TransactionHandle, _In_ BOOLEAN Wait)

Definition at line 307 of file nttmapi.h.

PFN_NT_SET_INFORMATION_TRANSACTION

typedef NTSTATUS(NTAPI * PFN_NT_SET_INFORMATION_TRANSACTION) (_In_ HANDLE TransactionHandle, _In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass, _In_ PVOID TransactionInformation, _In_ ULONG TransactionInformationLength)

Definition at line 295 of file nttmapi.h.

PKTMOBJECT_CURSOR

typedef struct _KTMOBJECT_CURSOR * PKTMOBJECT_CURSOR

PKTMOBJECT_TYPE

typedef enum _KTMOBJECT_TYPE * PKTMOBJECT_TYPE

PRESOURCEMANAGER_BASIC_INFORMATION

typedef struct _RESOURCEMANAGER_BASIC_INFORMATION * PRESOURCEMANAGER_BASIC_INFORMATION

PRESOURCEMANAGER_COMPLETION_INFORMATION

typedef struct _RESOURCEMANAGER_COMPLETION_INFORMATION * PRESOURCEMANAGER_COMPLETION_INFORMATION

PTRANSACTION_BASIC_INFORMATION

typedef struct _TRANSACTION_BASIC_INFORMATION * PTRANSACTION_BASIC_INFORMATION

PTRANSACTION_BIND_INFORMATION

typedef struct _TRANSACTION_BIND_INFORMATION * PTRANSACTION_BIND_INFORMATION

PTRANSACTION_ENLISTMENT_PAIR

typedef struct _TRANSACTION_ENLISTMENT_PAIR * PTRANSACTION_ENLISTMENT_PAIR

PTRANSACTION_ENLISTMENTS_INFORMATION

typedef struct _TRANSACTION_ENLISTMENTS_INFORMATION * PTRANSACTION_ENLISTMENTS_INFORMATION

PTRANSACTION_LIST_ENTRY

typedef struct _TRANSACTION_LIST_ENTRY * PTRANSACTION_LIST_ENTRY

PTRANSACTION_LIST_INFORMATION

typedef struct _TRANSACTION_LIST_INFORMATION * PTRANSACTION_LIST_INFORMATION

PTRANSACTION_PROPERTIES_INFORMATION

typedef struct _TRANSACTION_PROPERTIES_INFORMATION * PTRANSACTION_PROPERTIES_INFORMATION

PTRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION

typedef struct _TRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION * PTRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION

PTRANSACTIONMANAGER_BASIC_INFORMATION

typedef struct _TRANSACTIONMANAGER_BASIC_INFORMATION * PTRANSACTIONMANAGER_BASIC_INFORMATION

PTRANSACTIONMANAGER_LOG_INFORMATION

typedef struct _TRANSACTIONMANAGER_LOG_INFORMATION * PTRANSACTIONMANAGER_LOG_INFORMATION

PTRANSACTIONMANAGER_LOGPATH_INFORMATION

typedef struct _TRANSACTIONMANAGER_LOGPATH_INFORMATION * PTRANSACTIONMANAGER_LOGPATH_INFORMATION

PTRANSACTIONMANAGER_RECOVERY_INFORMATION

typedef struct _TRANSACTIONMANAGER_RECOVERY_INFORMATION * PTRANSACTIONMANAGER_RECOVERY_INFORMATION

RESOURCEMANAGER_BASIC_INFORMATION

typedef struct _RESOURCEMANAGER_BASIC_INFORMATION RESOURCEMANAGER_BASIC_INFORMATION

RESOURCEMANAGER_COMPLETION_INFORMATION

typedef struct _RESOURCEMANAGER_COMPLETION_INFORMATION RESOURCEMANAGER_COMPLETION_INFORMATION

RESOURCEMANAGER_INFORMATION_CLASS

typedef enum _RESOURCEMANAGER_INFORMATION_CLASS RESOURCEMANAGER_INFORMATION_CLASS

TRANSACTION_BASIC_INFORMATION

typedef struct _TRANSACTION_BASIC_INFORMATION TRANSACTION_BASIC_INFORMATION

TRANSACTION_BIND_INFORMATION

typedef struct _TRANSACTION_BIND_INFORMATION TRANSACTION_BIND_INFORMATION

TRANSACTION_ENLISTMENT_PAIR

typedef struct _TRANSACTION_ENLISTMENT_PAIR TRANSACTION_ENLISTMENT_PAIR

TRANSACTION_ENLISTMENTS_INFORMATION

typedef struct _TRANSACTION_ENLISTMENTS_INFORMATION TRANSACTION_ENLISTMENTS_INFORMATION

TRANSACTION_INFORMATION_CLASS

typedef enum _TRANSACTION_INFORMATION_CLASS TRANSACTION_INFORMATION_CLASS

TRANSACTION_LIST_ENTRY

typedef struct _TRANSACTION_LIST_ENTRY TRANSACTION_LIST_ENTRY

TRANSACTION_LIST_INFORMATION

typedef struct _TRANSACTION_LIST_INFORMATION TRANSACTION_LIST_INFORMATION

TRANSACTION_OUTCOME

typedef enum _TRANSACTION_OUTCOME TRANSACTION_OUTCOME

TRANSACTION_PROPERTIES_INFORMATION

typedef struct _TRANSACTION_PROPERTIES_INFORMATION TRANSACTION_PROPERTIES_INFORMATION

TRANSACTION_STATE

typedef enum _TRANSACTION_STATE TRANSACTION_STATE

TRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION

typedef struct _TRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION TRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION

TRANSACTIONMANAGER_BASIC_INFORMATION

typedef struct _TRANSACTIONMANAGER_BASIC_INFORMATION TRANSACTIONMANAGER_BASIC_INFORMATION

TRANSACTIONMANAGER_INFORMATION_CLASS

typedef enum _TRANSACTIONMANAGER_INFORMATION_CLASS TRANSACTIONMANAGER_INFORMATION_CLASS

TRANSACTIONMANAGER_LOG_INFORMATION

typedef struct _TRANSACTIONMANAGER_LOG_INFORMATION TRANSACTIONMANAGER_LOG_INFORMATION

TRANSACTIONMANAGER_LOGPATH_INFORMATION

typedef struct _TRANSACTIONMANAGER_LOGPATH_INFORMATION TRANSACTIONMANAGER_LOGPATH_INFORMATION

TRANSACTIONMANAGER_RECOVERY_INFORMATION

typedef struct _TRANSACTIONMANAGER_RECOVERY_INFORMATION TRANSACTIONMANAGER_RECOVERY_INFORMATION

Enumeration Type Documentation

_ENLISTMENT_INFORMATION_CLASS

enum _ENLISTMENT_INFORMATION_CLASS

Enumerator
EnlistmentBasicInformation
EnlistmentRecoveryInformation
EnlistmentCrmInformation

Definition at line 247 of file nttmapi.h.

                                           {
  EnlistmentBasicInformation,
  EnlistmentRecoveryInformation,
  EnlistmentCrmInformation
} ENLISTMENT_INFORMATION_CLASS;

_KTMOBJECT_TYPE

enum _KTMOBJECT_TYPE

Enumerator
KTMOBJECT_TRANSACTION
KTMOBJECT_TRANSACTION_MANAGER
KTMOBJECT_RESOURCE_MANAGER
KTMOBJECT_ENLISTMENT
KTMOBJECT_INVALID

Definition at line 202 of file nttmapi.h.

                             {
  KTMOBJECT_TRANSACTION,
  KTMOBJECT_TRANSACTION_MANAGER,
  KTMOBJECT_RESOURCE_MANAGER,
  KTMOBJECT_ENLISTMENT,
  KTMOBJECT_INVALID
} KTMOBJECT_TYPE, *PKTMOBJECT_TYPE;

_RESOURCEMANAGER_INFORMATION_CLASS

enum _RESOURCEMANAGER_INFORMATION_CLASS

Enumerator
ResourceManagerBasicInformation
ResourceManagerCompletionInformation

Definition at line 230 of file nttmapi.h.

                                                {
  ResourceManagerBasicInformation,
  ResourceManagerCompletionInformation,
} RESOURCEMANAGER_INFORMATION_CLASS;

_TRANSACTION_INFORMATION_CLASS

enum _TRANSACTION_INFORMATION_CLASS

Enumerator
TransactionBasicInformation
TransactionPropertiesInformation
TransactionEnlistmentInformation
TransactionSuperiorEnlistmentInformation

Definition at line 216 of file nttmapi.h.

                                            {
  TransactionBasicInformation,
  TransactionPropertiesInformation,
  TransactionEnlistmentInformation,
  TransactionSuperiorEnlistmentInformation
} TRANSACTION_INFORMATION_CLASS;

_TRANSACTION_OUTCOME

enum _TRANSACTION_OUTCOME

Enumerator
TransactionOutcomeUndetermined
TransactionOutcomeCommitted
TransactionOutcomeAborted

Definition at line 126 of file nttmapi.h.

                                  {
  TransactionOutcomeUndetermined = 1,
  TransactionOutcomeCommitted,
  TransactionOutcomeAborted,
} TRANSACTION_OUTCOME;

_TRANSACTION_STATE

enum _TRANSACTION_STATE

Enumerator
TransactionStateNormal
TransactionStateIndoubt
TransactionStateCommittedNotify

Definition at line 133 of file nttmapi.h.

                                {
  TransactionStateNormal = 1,
  TransactionStateIndoubt,
  TransactionStateCommittedNotify,
} TRANSACTION_STATE;

_TRANSACTIONMANAGER_INFORMATION_CLASS

enum _TRANSACTIONMANAGER_INFORMATION_CLASS

Enumerator
TransactionManagerBasicInformation
TransactionManagerLogInformation
TransactionManagerLogPathInformation
TransactionManagerRecoveryInformation

Definition at line 223 of file nttmapi.h.

                                                   {
  TransactionManagerBasicInformation,
  TransactionManagerLogInformation,
  TransactionManagerLogPathInformation,
  TransactionManagerRecoveryInformation = 4
} TRANSACTIONMANAGER_INFORMATION_CLASS;

Function Documentation

_In_reads_bytes_() [1/4]

_Must_inspect_result_ _In_ ENLISTMENT_INFORMATION_CLASS _In_reads_bytes_

(

EnlistmentInformationLength

)

_In_reads_bytes_() [2/4]

_Must_inspect_result_ _In_ RESOURCEMANAGER_INFORMATION_CLASS _In_reads_bytes_

(

ResourceManagerInformationLength

)

_In_reads_bytes_() [3/4]

_Must_inspect_result_ _In_ TRANSACTION_INFORMATION_CLASS _In_reads_bytes_

(

TransactionInformationLength

)

_In_reads_bytes_() [4/4]

_Must_inspect_result_ _In_ TRANSACTIONMANAGER_INFORMATION_CLASS _In_reads_bytes_

(

TransactionManagerInformationLength

)

_Inout_updates_bytes_()

_Must_inspect_result_ _In_ KTMOBJECT_TYPE _Inout_updates_bytes_

(

ObjectCursorLength

)

_IRQL_requires_max_()

_Must_inspect_result_ _IRQL_requires_max_

(

APC_LEVEL

)

Probes and locks virtual pages in memory for the specified process.

Parameters

[in,out]	MemoryDescriptorList	Memory Descriptor List (MDL) containing the buffer to be probed and locked.
[in]	Process	The process for which the buffer should be probed and locked.
[in]	AccessMode	Access mode for probing the pages. Can be KernelMode or UserMode.
[in]	LockOperation	The type of the probing and locking operation. Can be IoReadAccess, IoWriteAccess or IoModifyAccess.

Returns

Nothing.

See also

MmProbeAndLockPages

Remarks

Must be called at IRQL <= APC_LEVEL

Probes and locks virtual pages in memory for the specified process.

Frees previously reserved amount of memory in system virtual address space.

Parameters

[in]	NumberOfBytes	Size, in bytes, of memory to reserve.
[in]	PoolTag	Pool Tag identifying the buffer. Usually consists from 4 characters in reversed order.

Returns

A pointer to the 1st memory block of the reserved buffer in case of success, NULL otherwise.

Remarks

Must be called at IRQL <= APC_LEVEL

Parameters

[in]	BaseAddress	A pointer to the 1st memory block of the reserved buffer.
[in]	PoolTag	Pool Tag identifying the buffer. Usually consists from 4 characters in reversed order.

Returns

Nothing.

See also

MmAllocateMappingAddress

Remarks

Must be called at IRQL <= APC_LEVEL

Definition at line 37 of file cddata.c.

{
    THREAD_CONTEXT ThreadContext = {0};
    PIRP_CONTEXT IrpContext = NULL;
    BOOLEAN Wait;
 
#ifdef CD_SANITY
    PVOID PreviousTopLevel;
#endif
 
    NTSTATUS Status;
 
#if DBG
 
    KIRQL SaveIrql = KeGetCurrentIrql();
 
#endif
 
    ASSERT_OPTIONAL_IRP( Irp );
 
    UNREFERENCED_PARAMETER( DeviceObject );
 
    FsRtlEnterFileSystem();
 
#ifdef CD_SANITY
    PreviousTopLevel = IoGetTopLevelIrp();
#endif
 
    //
    //  Loop until this request has been completed or posted.
    //
 
    do {
 
        //
        //  Use a try-except to handle the exception cases.
        //
 
        _SEH2_TRY {
 
            //
            //  If the IrpContext is NULL then this is the first pass through
            //  this loop.
            //
 
            if (IrpContext == NULL) {
 
                //
                //  Decide if this request is waitable an allocate the IrpContext.
                //  If the file object in the stack location is NULL then this
                //  is a mount which is always waitable.  Otherwise we look at
                //  the file object flags.
                //
 
                if (IoGetCurrentIrpStackLocation( Irp )->FileObject == NULL) {
 
                    Wait = TRUE;
 
                } else {
 
                    Wait = CanFsdWait( Irp );
                }
 
                IrpContext = CdCreateIrpContext( Irp, Wait );
 
                //
                //  Update the thread context information.
                //
 
                CdSetThreadContext( IrpContext, &ThreadContext );
 
#ifdef CD_SANITY
                NT_ASSERT( !CdTestTopLevel ||
                        SafeNodeType( IrpContext->TopLevel ) == CDFS_NTC_IRP_CONTEXT );
#endif
 
            //
            //  Otherwise cleanup the IrpContext for the retry.
            //
 
            } else {
 
                //
                //  Set the MORE_PROCESSING flag to make sure the IrpContext
                //  isn't inadvertently deleted here.  Then cleanup the
                //  IrpContext to perform the retry.
                //
 
                SetFlag( IrpContext->Flags, IRP_CONTEXT_FLAG_MORE_PROCESSING );
                CdCleanupIrpContext( IrpContext, FALSE );
            }
 
            //
            //  Case on the major irp code.
            //
 
            switch (IrpContext->MajorFunction) {
 
            case IRP_MJ_CREATE :
 
                Status = CdCommonCreate( IrpContext, Irp );
                break;
 
            case IRP_MJ_CLOSE :
 
                Status = CdCommonClose( IrpContext, Irp );
                break;
 
            case IRP_MJ_READ :
 
                //
                //  If this is an Mdl complete request, don't go through
                //  common read.
                //
 
                if (FlagOn( IrpContext->MinorFunction, IRP_MN_COMPLETE )) {
 
                    Status = CdCompleteMdl( IrpContext, Irp );
 
                } else {
 
                    Status = CdCommonRead( IrpContext, Irp );
                }
 
                break;
 
            case IRP_MJ_WRITE :
 
                Status = CdCommonWrite( IrpContext, Irp );
                break;
 
            case IRP_MJ_QUERY_INFORMATION :
 
                Status = CdCommonQueryInfo( IrpContext, Irp );
                break;
 
            case IRP_MJ_SET_INFORMATION :
 
                Status = CdCommonSetInfo( IrpContext, Irp );
                break;
 
            case IRP_MJ_QUERY_VOLUME_INFORMATION :
 
                Status = CdCommonQueryVolInfo( IrpContext, Irp );
                break;
 
            case IRP_MJ_DIRECTORY_CONTROL :
 
                Status = CdCommonDirControl( IrpContext, Irp );
                break;
 
            case IRP_MJ_FILE_SYSTEM_CONTROL :
 
                Status = CdCommonFsControl( IrpContext, Irp );
                break;
 
            case IRP_MJ_DEVICE_CONTROL :
 
                Status = CdCommonDevControl( IrpContext, Irp );
                break;
 
            case IRP_MJ_LOCK_CONTROL :
 
                Status = CdCommonLockControl( IrpContext, Irp );
                break;
 
            case IRP_MJ_CLEANUP :
 
                Status = CdCommonCleanup( IrpContext, Irp );
                break;
 
            case IRP_MJ_PNP :
 
                Status = CdCommonPnp( IrpContext, Irp );
                break;
 
            case IRP_MJ_SHUTDOWN :
 
                Status = CdCommonShutdown( IrpContext, Irp );
                break;
 
            default :
 
                Status = STATUS_INVALID_DEVICE_REQUEST;
                CdCompleteRequest( IrpContext, Irp, Status );
            }
 
        } _SEH2_EXCEPT( CdExceptionFilter( IrpContext, _SEH2_GetExceptionInformation() )) {
 
            Status = CdProcessException( IrpContext, Irp, _SEH2_GetExceptionCode() );
        } _SEH2_END;
 
    } while (Status == STATUS_CANT_WAIT);
 
#ifdef CD_SANITY
    NT_ASSERT( !CdTestTopLevel ||
            (PreviousTopLevel == IoGetTopLevelIrp()) );
#endif
 
    FsRtlExitFileSystem();
 
    NT_ASSERT( SaveIrql == KeGetCurrentIrql( ));
 
    return Status;
}

_Out_writes_bytes_() [1/4]

_Must_inspect_result_ _In_ ENLISTMENT_INFORMATION_CLASS _Out_writes_bytes_

(

EnlistmentInformationLength

)

_Out_writes_bytes_() [2/4]

_Must_inspect_result_ _In_ RESOURCEMANAGER_INFORMATION_CLASS _Out_writes_bytes_

(

ResourceManagerInformationLength

)

_Out_writes_bytes_() [3/4]

_Must_inspect_result_ _In_ TRANSACTION_INFORMATION_CLASS _Out_writes_bytes_

(

TransactionInformationLength

)

_Out_writes_bytes_() [4/4]

_Must_inspect_result_ _In_ TRANSACTIONMANAGER_INFORMATION_CLASS _Out_writes_bytes_

(

TransactionManagerInformationLength

)

Variable Documentation

Asynchronous

_Must_inspect_result_ _Out_ PTRANSACTION_NOTIFICATION _In_ ULONG _In_opt_ PLARGE_INTEGER _Out_opt_ PULONG _In_ ULONG Asynchronous

Definition at line 689 of file nttmapi.h.

AsynchronousContext

_Must_inspect_result_ _Out_ PTRANSACTION_NOTIFICATION _In_ ULONG _In_opt_ PLARGE_INTEGER _Out_opt_ PULONG _In_ ULONG _In_opt_ ULONG_PTR AsynchronousContext

Definition at line 690 of file nttmapi.h.

Buffer

_In_ ULONG _In_ ULONG _In_ PVOID Buffer

Definition at line 739 of file nttmapi.h.

BufferLength

_In_ ULONG _In_ ULONG BufferLength

Definition at line 738 of file nttmapi.h.

CommitStrength

_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ PUNICODE_STRING _In_opt_ ULONG _In_opt_ ULONG CommitStrength

Definition at line 326 of file nttmapi.h.

CreateOptions

_Must_inspect_result_ _In_ PCRM_PROTOCOL_ID _In_ ULONG _In_ PVOID _In_opt_ ULONG CreateOptions

Definition at line 325 of file nttmapi.h.

Description

_In_ ACCESS_MASK _In_ HANDLE _In_opt_ LPGUID _In_opt_ POBJECT_ATTRIBUTES _In_opt_ ULONG _In_opt_ PUNICODE_STRING Description

Definition at line 425 of file nttmapi.h.

DesiredAccess

_Must_inspect_result_ _In_ ACCESS_MASK DesiredAccess

Definition at line 322 of file nttmapi.h.

EnlistmentGuid

_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE _In_ LPGUID EnlistmentGuid

Definition at line 509 of file nttmapi.h.

EnlistmentInformationClass

_In_ ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass

Definition at line 520 of file nttmapi.h.

EnlistmentInformationLength

_In_ ENLISTMENT_INFORMATION_CLASS _In_ ULONG EnlistmentInformationLength

Definition at line 522 of file nttmapi.h.

EnlistmentKey

_In_opt_ PVOID EnlistmentKey

Definition at line 497 of file nttmapi.h.

ExistingTransactionManagerGuid

_Must_inspect_result_ _In_ LPGUID ExistingTransactionManagerGuid

Definition at line 350 of file nttmapi.h.

IsolationFlags

_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ LPGUID _In_opt_ HANDLE _In_opt_ ULONG _In_opt_ ULONG _In_opt_ ULONG IsolationFlags

Definition at line 423 of file nttmapi.h.

IsolationLevel

_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ LPGUID _In_opt_ HANDLE _In_opt_ ULONG _In_opt_ ULONG IsolationLevel

Definition at line 422 of file nttmapi.h.

LogFileName

_In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ PUNICODE_STRING LogFileName

Definition at line 324 of file nttmapi.h.

Referenced by InitLog(), SetupInitializeFileLogA(), SetupInitializeFileLogW(), and WinMain().

NotificationLength

_Must_inspect_result_ _Out_ PTRANSACTION_NOTIFICATION _In_ ULONG NotificationLength

Definition at line 686 of file nttmapi.h.

NotificationMask

_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE _In_ HANDLE _In_opt_ POBJECT_ATTRIBUTES _In_opt_ ULONG _In_ NOTIFICATION_MASK NotificationMask

Definition at line 496 of file nttmapi.h.

ObjectAttributes

_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE _In_opt_ LPGUID _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes

Definition at line 323 of file nttmapi.h.

ObjectCursorLength

_Must_inspect_result_ _In_ KTMOBJECT_TYPE _In_ ULONG ObjectCursorLength

Definition at line 406 of file nttmapi.h.

OpenOptions

_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ PUNICODE_STRING _In_opt_ LPGUID _In_opt_ ULONG OpenOptions

Definition at line 340 of file nttmapi.h.

PropStatus

_In_ ULONG _In_ NTSTATUS PropStatus

Definition at line 749 of file nttmapi.h.

ProtocolId

_Must_inspect_result_ _In_ PCRM_PROTOCOL_ID ProtocolId

Definition at line 725 of file nttmapi.h.

ProtocolInformation

_Must_inspect_result_ _In_ PCRM_PROTOCOL_ID _In_ ULONG _In_ PVOID ProtocolInformation

Definition at line 727 of file nttmapi.h.

ProtocolInformationSize

_Must_inspect_result_ _In_ PCRM_PROTOCOL_ID _In_ ULONG ProtocolInformationSize

Definition at line 726 of file nttmapi.h.

QueryType

_Must_inspect_result_ _In_ KTMOBJECT_TYPE QueryType

Definition at line 404 of file nttmapi.h.

Referenced by IopValidateID(), NdrFullPointerQueryPointer(), NdrFullPointerQueryRefId(), PciQueryDeviceText(), PciQueryId(), and TdiQueryInformation().

RequestCookie

_In_ ULONG RequestCookie

Definition at line 737 of file nttmapi.h.

ResourceManagerGuid

_In_ ACCESS_MASK _In_ HANDLE _In_ LPGUID ResourceManagerGuid

Definition at line 665 of file nttmapi.h.

ResourceManagerHandle

_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE ResourceManagerHandle

Definition at line 492 of file nttmapi.h.

ResourceManagerInformationClass

_In_ RESOURCEMANAGER_INFORMATION_CLASS ResourceManagerInformationClass

Definition at line 700 of file nttmapi.h.

ResourceManagerInformationLength

_In_ RESOURCEMANAGER_INFORMATION_CLASS _In_ ULONG ResourceManagerInformationLength

Definition at line 702 of file nttmapi.h.

ReturnLength

_Must_inspect_result_ _In_ RESOURCEMANAGER_INFORMATION_CLASS _In_ ULONG _Out_opt_ PULONG ReturnLength

Definition at line 382 of file nttmapi.h.

RmGuid

_Must_inspect_result_ _In_ ACCESS_MASK _In_ HANDLE _In_ LPGUID RmGuid

Definition at line 650 of file nttmapi.h.

Timeout

_Must_inspect_result_ _Out_ PTRANSACTION_NOTIFICATION _In_ ULONG _In_opt_ PLARGE_INTEGER Timeout

Definition at line 424 of file nttmapi.h.

TmHandle

_In_ ACCESS_MASK _In_ HANDLE TmHandle

Definition at line 420 of file nttmapi.h.

TmIdentity

_Must_inspect_result_ _In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_opt_ PUNICODE_STRING _In_opt_ LPGUID TmIdentity

Definition at line 339 of file nttmapi.h.

TmVirtualClock

_In_opt_ PLARGE_INTEGER TmVirtualClock

Definition at line 360 of file nttmapi.h.

TransactionHandle

_In_ ACCESS_MASK _In_ POBJECT_ATTRIBUTES _In_ ULONG _In_ HANDLE TransactionHandle

Definition at line 493 of file nttmapi.h.

TransactionInformationClass

_In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass

Definition at line 448 of file nttmapi.h.

TransactionInformationLength

_In_ TRANSACTION_INFORMATION_CLASS _In_ PVOID _In_ ULONG TransactionInformationLength

Definition at line 450 of file nttmapi.h.

TransactionManagerInformationClass

_In_ TRANSACTIONMANAGER_INFORMATION_CLASS TransactionManagerInformationClass

Definition at line 379 of file nttmapi.h.

TransactionManagerInformationLength

_In_ TRANSACTIONMANAGER_INFORMATION_CLASS _In_ PVOID _In_ ULONG TransactionManagerInformationLength

Definition at line 381 of file nttmapi.h.

TransactionNotification

_Must_inspect_result_ _Out_ PTRANSACTION_NOTIFICATION TransactionNotification

Definition at line 685 of file nttmapi.h.

Uow

_In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_ LPGUID Uow

Definition at line 419 of file nttmapi.h.

Wait

_In_ BOOLEAN Wait

Definition at line 472 of file nttmapi.h.