FLT_PARAMETERS pour IRP_MJ_CREATE_NAMED_PIPE union
La structure suivante dans l’union FLT_PARAMETERS est utilisée lorsque le champ MajorFunction de la structure FLT_IO_PARAMETER_BLOCK est IRP_MJ_CREATE_NAMED_PIPE.
Syntaxe
typedef union _FLT_PARAMETERS {
... ;
struct {
PIO_SECURITY_CONTEXT SecurityContext;
ULONG Options;
USHORT POINTER_ALIGNMENT Reserved;
USHORT ShareAccess;
PVOID Parameters;
} CreatePipe;
... ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;
Membres
La structure CreatePipe de FLT_PARAMETERS contient les membres suivants.
SecurityContext : pointeur vers une structure de IO_SECURITY_CONTEXT qui représente le contexte de sécurité d’une demande de IRP_MJ_CREATE_NAMED_PIPE, où :
SecurityContext->AccessState est un pointeur vers une structure ACCESS_STATE qui contient le contexte d’objet de l’objet, les types d’accès accordés et les types d’accès souhaités restants.
SecurityContext->DesiredAccess est une structure ACCESS_MASK qui spécifie les droits d’accès demandés pour le canal nommé. Pour plus d’informations, consultez le paramètre DesiredAccess de FltCreateNamedPipeFile.
Options : masque de bits d’indicateurs qui spécifient les options à appliquer lors de la création ou de l’ouverture du canal nommé, ainsi que l’action à entreprendre si le canal existe déjà. Les 24 bits de ce membre correspondent au paramètre CreateOptions pour FltCreateNamedPipeFile. Les 8 bits élevés correspondent au paramètre CreateDisposition à FltCreateNamedPipeFile.
Réservé : réservé ; n’utilisez pas.
ShareAccess : masque de bits des droits d’accès au partage demandés pour le fichier de canal nommé. Si ce paramètre est égal à zéro, l’accès exclusif est demandé. Pour plus d’informations, consultez le paramètre ShareAccess pour FltCreateNamedPipeFile.
Paramètres : pointeur vers une structure de NAMED_PIPE_CREATE_PARAMETERS contenant des informations sur le canal nommé en cours de création ou d’ouverture.
Remarques
FLT_PARAMETERS contient une structure CreatePipe lorsque l’opération d’E/S est IRP_MJ_CREATE_NAMED_PIPE. L’opération d’E/S est représentée par une structure FLT_CALLBACK_DATA , avec les paramètres d’opération contenus dans la structure de FLT_IO_PARAMETER_BLOCK vers laquelle pointe le paramètre Iopb des données de rappel.
Un pilote de minifiltre de système de fichiers qui a inscrit une routine de rappel pour les opérations de IRP_MJ_CREATE_NAMED_PIPE doit effectuer le traitement et le retour nécessaires.
Notez que, à part le dernier champ longword, les champs de la structure CreatePipe doivent correspondre à ceux de la structure Create .
IRP_MJ_CREATE_NAMED_PIPE est une opération basée sur IRP.
Configuration requise
| Type d’exigence | Condition requise |
|---|---|
| En-tête | Fltkernel.h (inclure Fltkernel.h) |