ECP yang ditentukan sistem

[!NOTE]

Beberapa informasi berkaitan dengan produk prarilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Halaman ini mencantumkan dan menjelaskan parameter pembuatan tambahan (ECP) yang ditentukan sistem. Sistem operasi mendefinisikan ECP ini dalam file header Ntifs.h .

ECP yang ditentukan sistem ini melampirkan informasi tambahan yang ditentukan ke operasi IRP_MJ_CREATE pada file. Elemen tumpukan sistem file dapat mengkueri ECP untuk informasi tambahan.

Biasanya, filter yang memproses operasi IRP_MJ_CREATE pada file dan kemudian meneruskan file ke filter di bawahnya tidak boleh melampirkan dan spoof salah satu ECP yang ditentukan sistem ke operasi IRP_MJ_CREATE pada file.

Demikian pula, driver mode kernel yang memproses dan mengeluarkan operasi IRP_MJ_CREATE pada file tidak boleh melampirkan dan menipu ECP yang ditentukan sistem apa pun ke operasi IRP_MJ_CREATE pada file.

Driver filter harus mempertimbangkan ECP yang ditentukan sistem sebagai baca-saja. Anda harus menggunakannya untuk mengambil informasi saja.

Salah satu pengecualian untuk membatasi driver filter agar tidak melampirkan salah satu ECP yang ditentukan sistem berikut adalah ketika driver filter menerapkan sistem file berlapis. Ini dilakukan dengan memiliki objek file dan dengan mengeluarkan operasi IRP_MJ_CREATE sendiri pada file di bawah filternya, sebagai respons terhadap operasi IRP_MJ_CREATE pada file yang layanan driver filter pada objek filenya sendiri. Driver filter seperti itu harus menyebarluaskan daftar struktur konteks ECP_LIST dari operasi IRP_MJ_CREATE asli pada file ke operasi IRP_MJ_CREATE yang masalah driver filter di bawahnya. Dengan menyebarkan daftar ECP ini, driver filter memastikan bahwa filter apa pun di bawah filter yang mengeluarkan operasi IRP_MJ_CREATE mengetahui konteks operasi IRP_MJ_CREATE asli.

ECP GUID	Struktur dan makna konteks ECP
ECP_TYPE_CLFS_CREATE_CONTAINER	GUID yang digunakan untuk mengidentifikasi struktur konteks ECP CREATE_REDIRECTION_ECP_CONTEXT. ECP ini dapat dikirim ke NTFS untuk menyisipkan kontainer sistem file log umum (CLFS) baru selama pemasangan volume.
ECP_TYPE_IO_STOP_ON_SYMLINK_FILTER_GUID	GUID yang mengidentifikasi struktur konteks ECP IO_STOP_ON_SYMLINK_FILTER_ECP_v0. ECP ini membatasi perilaku IO_STOP_ON_SYMLINK untuk bertindak hanya pada tag reparse tertentu.
ECP_TYPE_OPEN_REPARSE_GUID	GUID yang mengidentifikasi struktur konteks ECP OPEN_REPARSE_LIST. ECP ini mendukung penelepon yang membuka titik pemisahan ulang tertentu tanpa menghambat perilaku pemisahan ulang untuk semua kelas titik pemisahan ulang.
GUID_ECP_ATOMIC_CREATE	GUID yang mengidentifikasi struktur konteks ECP ATOMIC_CREATE_ECP_CONTEXT. ECP ini memungkinkan operasi tambahan tertentu untuk dilakukan pada file secara atomik selama pembuatan.
GUID_ECP_CLOUDFILES_ATTRIBUTION	GUID yang mengidentifikasi ECP untuk atribusi file cloud.
GUID_ECP_CREATE_REDIRECTION	GUID yang digunakan untuk mengidentifikasi ECP yang dapat dikirim untuk mengkueri status pengalihan file untuk operasi pembuatan tertentu.
GUID_ECP_CSV_DOWN_LEVEL_OPEN	GUID yang mengidentifikasi struktur konteks ECP CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT. Sistem file Cluster Shared Volumes (CSVFS) mengirimkan ECP ini ke Metadata Node (MDS), dan berisi informasi tentang jenis pembuatan.
GUID_ECP_CSV_QUERY_FILE_REVISION	GUID yang mengidentifikasi struktur konteks ECP CSV_QUERY_FILE_REVISION_ECP_CONTEXT. ECP ini dapat dikirim ke CSVFS untuk meminta nomor revisi file.
GUID_ECP_CSV_QUERY_FILE_REVISION_FILE_ID_128	GUID yang mengidentifikasi struktur konteks ECP CSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128. ECP ini dapat dikirim ke CSVFS untuk meminta nomor revisi file.
GUID_ECP_CSV_SET_HANDLE_PROPERTIES	GUID yang mengidentifikasi struktur konteks ECP CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT. ECP ini dapat dikirim ke CSVFS untuk mengatur properti tentang bagaimana ia harus menangani IO yang tiba pada pembukaan ini.
GUID_ECP_DUAL_OPLOCK_KEY	GUID yang mengidentifikasi struktur konteks DUAL OPLOCK_KEY_ECP_CONTEXT ECP. Seperti struktur OPLOCK_KEY_ECP_CONTEXT, OPLOCK_KEY_ECP_CONTEXT GANDA digunakan untuk melampirkan kunci oplock ke permintaan file terbuka. Dengan OPLOCK_KEY_ECP_CONTEXT GANDA, kunci induk juga dapat diatur untuk menyediakan oplock untuk direktori file target.
GUID_ECP_IO_DEVICE_HINT	GUID yang mengidentifikasi struktur IO_DEVICE_HINT_ECP_CONTEXT. Petunjuk perangkat digunakan untuk membantu driver minifilter penyedia nama dalam melacak target pemisahan ulang ke perangkat baru.
GUID_ECP_NETWORK_APP_INSTANCE	GUID yang mengidentifikasi struktur konteks ECP NETWORK_APP_INSTANCE_ECP_CONTEXT. Aplikasi klien dalam kluster failover mungkin memiliki sekumpulan file yang dibuka pada node di kluster. Objek file ditandai ke aplikasi oleh pengidentifikasi instans dalam struktur NETWORK_APP_INSTANCE_ECP_CONTEXT . Saat failover, simpul sekunder dapat memvalidasi akses aplikasi klien ke file yang dibuka dengan pengidentifikasi instans aplikasi yang di-cache sebelumnya.
GUID_ECP_NETWORK_APP_INSTANCE_VERSION	GUID yang mengidentifikasi struktur NETWORK_APP_INSTANCE_VERSION_ECP_CONTEXT , yang merupakan konteks ECP bagi aplikasi untuk memberikan ID instansnya. ECP ini harus menyertai NETWORK_APP_INSTANCE_ECP_CONTEXT (GUID_ECP_NETWORK_APP_INSTANCE) agar valid.
GUID_ECP_NETWORK_OPEN_CONTEXT	GUID yang mengidentifikasi struktur konteks ECP NETWORK_OPEN_ECP_CONTEXT dan digunakan untuk melampirkan informasi tambahan untuk pengalihan jaringan. GUID ini juga mengidentifikasi struktur NETWORK_OPEN_ECP_CONTEXT_V0 untuk driver yang berjalan pada Windows 7 dan versi Windows yang lebih baru dan yang harus menginterpretasikan konteks ECP jaringan pada file yang berada di Windows Vista.
GUID_ECP_NFS_OPEN	GUID yang mengidentifikasi struktur NFS_OPEN_ECP_CONTEXT. Server Network File System (NFS) melampirkan struktur NFS_OPEN_ECP_CONTEXT ke permintaan file terbuka. Server NFS menggunakan GUID ini pada permintaan file terbuka apa pun yang dilakukan server NFS untuk memenuhi permintaan klien. Tumpukan sistem file kemudian dapat menentukan apakah NFS_OPEN_ECP_CONTEXT dilampirkan ke permintaan file terbuka. Berdasarkan informasi dalam NFS_OPEN_ECP_CONTEXT tumpukan sistem file dapat menentukan klien yang meminta file dibuka dan mengapa.
GUID_ECP_OPEN_PARAMETERS	GUID yang mengidentifikasi struktur konteks ECP ECP_OPEN_PARAMETERS. ECP ini memungkinkan pemanggil untuk menentukan tujuan file terbuka tanpa mengganggu handel yang ada dan/atau kunci oportunistik (oplock) pada file.
GUID_ECP_OPLOCK_KEY	GUID yang mengidentifikasi struktur konteks ECP OPLOCK_KEY_ECP_CONTEXT dan digunakan untuk melampirkan kunci oplock ke permintaan file terbuka. Kunci oplock memungkinkan aplikasi membuka beberapa handel ke aliran yang sama tanpa merusak oplock aplikasi sendiri. Untuk informasi selengkapnya tentang oplock dan kunci oplock, lihat Gambaran Umum Oplock Semantics.
GUID_ECP_PREFETCH_OPEN	GUID yang mengidentifikasi struktur konteks ECP PREFETCH_OPEN_ECP_CONTEXT. Prefetcher adalah komponen OS yang terintegrasi erat dengan manajer cache dan manajer memori untuk membuat akses disk lebih efisien dan karenanya meningkatkan performa. Jika komponen lain mengganggu prefetcher, performa sistem menurun dan mungkin kebuntuan. Oleh karena itu, prefetcher melampirkan struktur PREFETCH_OPEN_ECP_CONTEXT ke file untuk berkomunikasi bahwa prefetcher melakukan permintaan terbuka pada file. Permintaan terbuka ini ditentukan oleh anggota Konteks PREFETCH_OPEN_ECP_CONTEXT. Komponen lain, seperti, driver filter sistem file, dapat menentukan apakah PREFETCH_OPEN_ECP_CONTEXT dilampirkan ke file dan kemudian mengambil tindakan yang sesuai.
GUID_ECP_QUERY_ON_CREATE	GUID yang mengidentifikasi ECP untuk informasi file kueri saat dibuat.
GUID_ECP_RKF_BYPASS	GUID yang mengidentifikasi struktur konteks ECP RKF_BYPASS_ECP_CONTEXT.
GUID_ECP_SRV_OPEN	GUID yang mengidentifikasi struktur konteks ECP SRV_OPEN_ECP_CONTEXT. Server melampirkan struktur SRV_OPEN_ECP_CONTEXT ke permintaan file terbuka. Server menggunakan GUID ini pada permintaan file terbuka apa pun yang dilakukan server untuk memenuhi permintaan klien kondisional. Tumpukan sistem file kemudian dapat menentukan apakah SRV_OPEN_ECP_CONTEXT dilampirkan ke permintaan file terbuka. Berdasarkan informasi dalam SRV_OPEN_ECP_CONTEXT tumpukan sistem file dapat menentukan klien yang meminta agar file dibuka dan mengapa.
GUID_ECP_TYPE_VETO_BINDING	Mengidentifikasi struktur konteks ECP VETO_BINDING_ECP_CONTEXT. ECP ini dapat digunakan untuk mem-veto tautan pengikatan pada partisi boot sistem. Tersedia mulai dari Windows 11, versi 24H2.