FLT_PARAMETERS per l'unione IRP_MJ_CREATE_NAMED_PIPE

Articolo
02/07/2024

La struttura seguente all'interno dell'unione FLT_PARAMETERS viene usata quando il campo MajorFunctiondella struttura FLT_IO_PARAMETER_BLOCK è IRP_MJ_CREATE_NAMED_PIPE.

Sintassi

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

Members

La struttura CreatePipe 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_NAMED_PIPE , dove:
Securitycontext->AccessState è un puntatore a una struttura ACCESS_STATE che contiene il contesto soggetto dell'oggetto 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 la pipe denominata. Per altre informazioni, vedere il parametro DesiredAccess di FltCreateNamedPipeFile.
Opzioni: Maschera di bit di flag che specificano le opzioni da applicare durante la creazione o l'apertura della pipe denominata, nonché l'azione da eseguire se la pipe esiste già. I 24 bit bassi di questo membro corrispondono al parametro CreateOptions per FltCreateNamedPipeFile. I 8 bit elevati corrispondono al parametro CreateDisposition a FltCreateNamedPipeFile.
Riservato: riservato; non usare.
ShareAccess: maschera bit dei diritti di accesso di condivisione richiesti per il file di pipe denominato. Se questo parametro è zero, viene richiesto l'accesso esclusivo. Per altre informazioni, vedere il parametro ShareAccess su FltCreateNamedPipeFile.
Parametri: puntatore a una struttura NAMED_PIPE_CREATE_PARAMETERS contenente informazioni sulla pipe denominata creata o aperta.

Commenti

FLT_PARAMETERS contiene una struttura CreatePipe quando l'operazione di I/O è IRP_MJ_CREATE_NAMED_PIPE. 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 del callback.

Un driver minifilter del file system che ha registrato una routine di callback per le operazioni di IRP_MJ_CREATE_NAMED_PIPE deve eseguire qualsiasi elaborazione necessaria e restituire.

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

IRP_MJ_CREATE_NAMED_PIPE è un'operazione basata su IRP.