FLT_PARAMETERS per l'unione IRP_MJ_CREATE_NAMED_PIPE
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 strutturaFLT_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.
Requisiti
Tipo di requisito | Requisito |
---|---|
Intestazione | Fltkernel.h (include Fltkernel.h) |