FLT_PARAMETERS untuk serikat IRP_MJ_CREATE_NAMED_PIPE

Artikel
02/02/2024

Struktur berikut dalam penyatuan FLT_PARAMETERS digunakan ketika bidang MajorFunction dari struktur FLT_IO_PARAMETER_BLOCK IRP_MJ_CREATE_NAMED_PIPE.

Sintaks

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

Anggota

Struktur CreatePipe FLT_PARAMETERS berisi anggota berikut.

SecurityContext: Penunjuk ke struktur IO_SECURITY_CONTEXT yang mewakili konteks keamanan permintaan IRP_MJ_CREATE_NAMED_PIPE, 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 pipa bernama. Untuk informasi selengkapnya, lihat parameter DesiredAccess dari FltCreateNamedPipeFile.
Opsi: Bitmask bendera yang menentukan opsi yang akan diterapkan saat membuat atau membuka pipa bernama, serta tindakan yang akan diambil jika pipa sudah ada. 24 bit rendah dari anggota ini sesuai dengan parameter CreateOptions untuk FltCreateNamedPipeFile. 8 bit tinggi sesuai dengan parameter CreateDisposition dengan FltCreateNamedPipeFile.
Dicadangkan: Dicadangkan; jangan gunakan.
ShareAccess: Bitmask hak akses berbagi yang diminta untuk file pipa bernama. Jika parameter ini nol, akses eksklusif sedang diminta. Untuk informasi selengkapnya, lihat parameter ShareAccess ke FltCreateNamedPipeFile.
Parameter: Penunjuk ke struktur NAMED_PIPE_CREATE_PARAMETERS yang berisi informasi tentang pipa bernama yang sedang dibuat atau dibuka.

Keterangan

FLT_PARAMETERS berisi struktur CreatePipe saat operasi I/O IRP_MJ_CREATE_NAMED_PIPE. 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_NAMED_PIPE harus melakukan pemrosesan dan pengembalian yang diperlukan.

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

IRP_MJ_CREATE_NAMED_PIPE adalah operasi berbasis IRP.