IRP_MJ_CREATE

Artikel
06/15/2023

Setiap driver mode kernel harus menangani permintaan IRP_MJ_CREATE dalam fungsi panggilan balik DRIVER_DISPATCH .

Ketika Dikirim

Sistem operasi mengirimkan permintaan IRP_MJ_CREATE untuk membuka handel ke objek file atau objek perangkat. Misalnya, ketika driver memanggil ZwCreateFile, sistem operasi mengirim permintaan IRP_MJ_CREATE untuk melakukan operasi terbuka aktual.

Parameter Input

Anggota Parameters.Create.SecurityContext menunjuk ke struktur IO_SECURITY_CONTEXT yang menjelaskan konteks keamanan untuk permintaan tersebut. Anggota Parameters.Create.SecurityContext-DesiredAccess> adalah masker akses yang menentukan hak akses yang diminta oleh pemanggil.

Anggota Parameters.Create.Options adalah nilai ULONG yang menjelaskan opsi yang digunakan saat membuka handel. 8 bit tinggi sesuai dengan nilai parameter CreateDispositionZwCreateFile, dan 24 bit rendah sesuai dengan nilai parameter CreateOptionsZwCreateFile.

Anggota Parameters.Create.ShareAccess adalah nilai USHORT yang menjelaskan jenis akses berbagi. Nilai ini sesuai dengan nilai parameter ShareAccess dari ZwCreateFile.

Anggota Parameters.Create.FileAttributes and Parameters.Create.EaLength dicadangkan untuk digunakan oleh sistem file dan driver filter sistem file. Untuk informasi selengkapnya, lihat topik IRP_MJ_CREATE dalam dokumentasi Installable File System (IFS).

Parameter Output

Tidak ada

Operasi

Sebagian besar driver perangkat dan perantara mengatur STATUS_SUCCESS di blok status I/O IRP dan menyelesaikan permintaan pembuatan, tetapi driver dapat secara opsional menggunakan fungsi panggilan balik DRIVER_DISPATCH mereka untuk memesan sumber daya untuk setiap permintaan I/O berikutnya untuk handel tersebut. Misalnya, driver serial sistem memetakan kode paged-out-nya dan mengalokasikan sumber daya apa pun yang diperlukan untuk menangani permintaan I/O berikutnya untuk utas mode pengguna yang mencoba membuka perangkat untuk input dan output.