struktur OPLOCK_KEY_ECP_CONTEXT (ntifs.h)
Struktur OPLOCK_KEY_ECP_CONTEXT digunakan untuk melampirkan kunci oplock ke file. Struktur ini usang untuk Windows 8 dan versi yang lebih baru; filter harus menggunakan DUAL_OP_LOCK_KEY_ECP_CONTEXT.
Sintaks
typedef struct _OPLOCK_KEY_ECP_CONTEXT {
GUID OplockKey;
ULONG Reserved;
} OPLOCK_KEY_ECP_CONTEXT, *POPLOCK_KEY_ECP_CONTEXT;
Anggota
OplockKey
GUID untuk kunci oplock. GUID ini dibagikan di antara berbagai handel dan mengidentifikasinya sebagai milik cache klien yang sama. Ketika dua handel berbagi kunci oplock yang sama, permintaan yang dilakukan pada satu handel tidak akan merusak oplock yang luar biasa pada handel lain.
Reserved
Dicadangkan. Harus diatur ke nol.
Keterangan
Untuk informasi tentang cara menggunakan ECP untuk mengaitkan informasi tambahan dengan file saat file dibuat, lihat Menggunakan Parameter Buat Ekstra dengan Operasi IRP_MJ_CREATE.
Minifilter tidak boleh mengubah konten struktur OPLOCK_KEY_ECP_CONTEXT ketika melihat ECP turun dari atas. Anda harus menggunakannya untuk mengambil informasi tentang ECP kunci oplock saja. Untuk informasi selengkapnya tentang masalah ini, lihat ECP yang Ditentukan Sistem.
Kunci oplock memungkinkan aplikasi untuk membuka beberapa handel ke aliran yang sama tanpa merusak oplock aplikasi sendiri. Pembobolan oplock hanya terjadi setelah aplikasi menerima pelanggaran berbagi (STATUS_SHARING_VIOLATION).
Oplock diberikan pada handel aliran saat aliran dibuka. Handel aliran seperti itu dapat dikaitkan dengan kunci oplock. Penelepon dapat secara eksplisit memberikan kunci oplock ke rutinitas IoCreateFileEx untuk membuat handel aliran. Jika pemanggil tidak secara eksplisit menentukan kunci oplock ketika pemanggil membuat handel, sistem operasi memperlakukan handel sebagai memiliki kunci oplock unik yang terkait dengan handel, sehingga kunci handel berbeda dari kunci lain pada handel lain. Jika operasi file diterima pada handel selain yang diberikan oplock, dan kunci oplock yang terkait dengan handel oplock berbeda dari kunci yang terkait dengan handel operasi, dan operasi tersebut tidak kompatibel dengan oplock yang saat ini diberikan, maka oplock tersebut rusak. Oplock rusak meskipun proses atau utas yang sama melakukan operasi yang tidak kompatibel. Misalnya, jika proses membuka aliran yang diberikan oplock eksklusif dan proses yang sama kemudian membuka aliran yang sama lagi, dengan menggunakan kunci oplock yang berbeda (atau tidak tidak), oplock eksklusif segera rusak.
Kunci Oplock dikaitkan dengan handel saat handel dibuat. Anda dapat mengaitkan handel dengan kunci oplock meskipun tidak ada oplock yang diberikan.
Untuk informasi selengkapnya tentang oplock dan kunci oplock, lihat Gambaran Umum Semantik Oplock.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 7; kedaluarsa mulai dari Windows 8 |
| Header | ntifs.h |