struktur CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT (ntifs.h)

Artikel
08/07/2023

Struktur CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT berisi konteks parameter buat ekstra (ECP) yang dapat dikirim ke sistem file Cluster Shared Volumes (CSV) untuk mengatur properti tentang bagaimana ia harus menangani IO yang tiba di tempat terbuka ini.

Sintaks

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

Anggota

Size

Ukuran struktur ini, dalam byte.

PauseTimeoutInSeconds

Jumlah detik bahwa CSVFS diizinkan untuk menahan IO yang dikeluarkan pada objek file ini dalam keadaan tertunda jika terjadi jeda volume CSV. Setelah waktu kedaluwarsa CSV akan menyelesaikan semua IO yang dikeluarkan pada objek file ini dengan status STATUS_CSV_IO_PAUSE_TIMEOUT. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0xFFFFFFFF	Menunjukkan bahwa tidak ada batas waktu, dan perilaku default diminta.
0	CSV tidak akan menjeda IO, dan akan segera menyelesaikan IO.
Nilai lainnya	CSV akan membulatkan semua nilai lainnya ke kelipatan 10 detik dan menggunakan nilai ini sebagai batas waktu. Nilai batas waktu maksimum yang didukung adalah 30 menit. Jika nilai yang disediakan lebih besar dari 30 menit, CSV akan secara diam-diam mengatur nilai ke nilai maksimum.

Flags

Bendera properti yang ditetapkan. Anggota ini bisa menjadi bitwise ATAU dari bendera berikut.

Bendera	Makna
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR	Memberi tahu CSVFS bahwa pembukaan file ini harus valid hanya pada simpul koordinat. Jika terbuka datang ke CSVFS dan simpul bukan simpul koordinat, pembukaan akan gagal. Jika file dibuka dan simpul koordinat dipindahkan, pembukaan file akan tidak valid. Bendera ini hanya digunakan ketika file dibuka langsung di CSVFS, dan diabaikan ketika file dibuka melalui SMB.

16 bit Bendera yang lebih rendah adalah untuk bendera yang akan menyebabkan pembuatan gagal dengan STATUS_INVALID_PARAMETER jika CSV tidak mengenalinya. 16 bit atas adalah untuk bendera yang akan diabaikan secara diam-diam jika CSVFS tidak tahu cara menanganinya.

Keterangan

Nilai GUID_ECP_CSV_SET_HANDLE_PROPERTIES yang ditentukan sistem digunakan dengan struktur konteks ECP ini saat memanggil rutinitas dukungan terkait ECP seperti FltAllocateExtraCreateParameter dan FsRtlRemoveExtraCreateParameter.

Lihat Pengantar parameter pembuatan tambahan untuk informasi selengkapnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Header	ntifs.h

Bagikan melalui