FLT_PARAMETERS untuk serikat IRP_MJ_CREATE_MAILSLOT

Artikel
03/14/2023

Struktur berikut dalam serikat FLT_PARAMETERS digunakan ketika bidang MajorFunction dari struktur FLT_IO_PARAMETER_BLOCK IRP_MJ_CREATE_MAILSLOT.

Sintaks

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIO_SECURITY_CONTEXT     SecurityContext;
    ULONG                    Options;
    USHORT POINTER_ALIGNMENT Reserved;
    USHORT                   ShareAccess;
    PVOID                    Parameters;
  } CreateMailslot;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Anggota

Struktur CreateMailslot FLT_PARAMETERS berisi anggota berikut.

SecurityContext: Penunjuk ke struktur IO_SECURITY_CONTEXT yang mewakili konteks keamanan permintaan IRP_MJ_CREATE_MAILSLOT, di mana:
SecurityContext->AccessState adalah penunjuk ke struktur ACCESS_STATE yang berisi konteks subjek objek, jenis akses yang diberikan, dan jenis akses yang diinginkan yang tersisa.
SecurityContext->DesiredAccess adalah struktur ACCESS_MASK yang menentukan hak akses yang diminta untuk mailslot. Untuk informasi selengkapnya, lihat parameter DesiredAccess dari FltCreateMailslotFile.
Opsi: Bitmask bendera yang menentukan opsi yang akan diterapkan saat membuat atau membuka mailslot, serta tindakan yang akan diambil jika mailslot sudah ada. 24 bit rendah dari anggota ini sesuai dengan parameter CreateOptions untuk FltCreateMailslotFile. 8 bit tinggi sesuai dengan parameter CreateDisposition untuk FltCreateMailslotFile.
Dicadangkan: Dicadangkan; jangan gunakan.
ShareAccess: Bitmask hak akses berbagi yang diminta untuk file mailslot. Jika parameter ini nol, akses eksklusif sedang diminta. Untuk informasi selengkapnya, lihat parameter ShareAccess ke FltCreateMailslotFile.
Parameter: Penunjuk ke struktur MAILSLOT_CREATE_PARAMETERS yang berisi informasi tentang mailslot yang sedang dibuat atau dibuka.

Keterangan

FLT_PARAMETERS berisi struktur CreateMailslot saat operasi I/O IRP_MJ_CREATE_MAILSLOT. Operasi I/O diwakili oleh struktur FLT_CALLBACK_DATA , dengan parameter operasi yang terkandung dalam struktur FLT_IO_PARAMETER_BLOCK yang ditunjuk oleh parameter Iopb data panggilan balik.

Driver minifilter sistem file yang telah mendaftarkan rutinitas panggilan balik untuk operasi IRP_MJ_CREATE_MAILSLOT harus melakukan pemrosesan dan pengembalian yang diperlukan.

Perhatikan bahwa, selain bidang kata panjang terakhir, bidang dalam struktur CreateMailslot harus cocok dengan bidang untuk struktur Buat .

IRP_MJ_CREATE_MAILSLOT adalah operasi berbasis IRP.