FLT_PARAMETERS per l'unione IRP_MJ_CREATE_MAILSLOT

Articolo
03/14/2023

La struttura seguente all'interno dell'unione FLT_PARAMETERS viene utilizzata quando viene IRP_MJ_CREATE_MAILSLOT il campo MajorFunction della struttura FLT_IO_PARAMETER_BLOCK.

Sintassi

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

Members

La struttura CreateMailslot di FLT_PARAMETERS contiene i membri seguenti.

SecurityContext: puntatore a una struttura IO_SECURITY_CONTEXT che rappresenta il contesto di sicurezza di una richiesta di IRP_MJ_CREATE_MAILSLOT, dove:
Securitycontext->AccessState è un puntatore a una struttura ACCESS_STATE che contiene il contesto del soggetto dell'oggetto, i tipi di accesso concessi e i tipi di accesso rimanenti desiderati.
Securitycontext->DesiredAccess è una struttura ACCESS_MASK che specifica i diritti di accesso richiesti per il mailslot. Per altre informazioni, vedere il parametro DesiredAccess di FltCreateMailslotFile.
Opzioni: maschera di bit di flag che specificano le opzioni da applicare durante la creazione o l'apertura della mailslot, nonché l'azione da eseguire se il mailslot esiste già. I 24 bit bassi di questo membro corrispondono al parametro CreateOptions per FltCreateMailslotFile. I 8 bit alti corrispondono al parametro CreateDisposition per FltCreateMailslotFile.
Riservato: riservato; non usare.
ShareAccess: maschera di bit dei diritti di accesso di condivisione richiesti per il file mailslot. Se questo parametro è zero, viene richiesto l'accesso esclusivo. Per altre informazioni, vedere il parametro ShareAccess in FltCreateMailslotFile.
Parametri: puntatore a una struttura MAILSLOT_CREATE_PARAMETERS contenente informazioni sul file mailslot che viene creato o aperto.

Commenti

FLT_PARAMETERS contiene una struttura CreateMailslot quando l'operazione di I/O è IRP_MJ_CREATE_MAILSLOT. L'operazione di I/O è rappresentata da una struttura FLT_CALLBACK_DATA , con i parametri dell'operazione contenuti nella struttura FLT_IO_PARAMETER_BLOCK a cui punta il parametro Iopb dei dati di callback.

Un driver minifilter del file system che ha registrato una routine di callback per IRP_MJ_CREATE_MAILSLOT operazioni deve eseguire qualsiasi elaborazione e restituzione necessarie.

Si noti che, oltre all'ultimo campo longword, i campi della struttura CreateMailslot devono corrispondere a quelli per la struttura Create .

IRP_MJ_CREATE_MAILSLOT è un'operazione basata su IRP.