struktur TXN_PARAMETER_BLOCK (ntddk.h)
Struktur TXN_PARAMETER_BLOCK berisi informasi tentang operasi file yang ditransaksikan.
Sintaks
typedef struct _TXN_PARAMETER_BLOCK {
USHORT Length;
USHORT TxFsContext;
PVOID TransactionObject;
} TXN_PARAMETER_BLOCK, *PTXN_PARAMETER_BLOCK;
Anggota
Length
Ukuran, dalam byte, dari struktur TXN_PARAMETER_BLOCK.
TxFsContext
ID miniversi untuk file.
TransactionObject
Penunjuk buram ke objek transaksi untuk transaksi.
Keterangan
Miniversion adalah versi file yang dibuat oleh penulis yang ditransaksikan selama transaksi. ( Penulis yang ditransaksikan adalah handel file yang ditransaksikan yang dibuka dengan izin apa pun yang bukan bagian dari akses baca generik, tetapi merupakan bagian dari akses tulis generik.)
Jika nomor miniversi tertentu untuk file tidak disediakan, anggota TxFsContext harus diatur ke TXF_MINIVERSION_DEFAULT_VIEW.
Anggota TxFsContextdari TXN_PARAMETER_BLOCK menggunakan TXF_MINIVERSION_DEFAULT_VIEW untuk mendapatkan tampilan default file yang diminta yang didasarkan pada nilai anggota TransactionObject . Jadi, jika TransactionObject adalah transaksi yang sama yang memiliki file yang diminta dikunci untuk modifikasi yang ditransaksikan, pemanggil dapat melihat modifikasi tersebut (tampilan "kotor" file) jika pemanggil dapat menentukan nilai anggota TransactionObject . Jika TransactionObject bukan transaksi yang sama dengan file yang diminta dikunci untuk modifikasi yang ditransaksikan, pemanggil mendapatkan tampilan file yang terisolasi secara transaksional jika menentukan nilai ini.
Miniversi hanya ada sebagai tampilan titik waktu file dan belum ditulis sebagai varian on-disk aktual dari file tertentu. Penulis yang ditransaksikan membuat miniversi dengan menggunakan kode kontrol FSCTL_TXFS_CREATE_MINIVERSION untuk memanggil ZwFsControlFile. Sebagai tanggapan, sistem membuat miniversi dan mengembalikan ID miniversinya. Penulis yang ditransaksikan dapat terus membuat perubahan pada file setelahnya. Jika file dibuka nanti dengan menggunakan ID miniversi yang dikembalikan sebagai anggota TxFsContext dari struktur TXN_PARAMETER_BLOCK , handel file yang dihasilkan menunjukkan file seperti pada saat miniversion dibuat.
Semua miniversi yang dibuat dalam transaksi hilang ketika transaksi berakhir. Setelah itu, file tidak dapat lagi dibuka dengan menggunakan ID miniversi.
Miniversi hanya tersedia untuk penulis yang ditransaksikan yang membuat miniversi, bukan untuk pembaca yang ditransaksikan atau pembaca yang tidak ditransaksikan.
Rutinitas IoGetTransactionParameterBlock mengembalikan pointer ke struktur ini.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | ntddk.h (termasuk Ntddk.h, Ntifs.h, FltKernel.h) |