FLT_PARAMETERS für IRP_MJ_CREATE_NAMED_PIPE Union
Die folgende Struktur innerhalb der FLT_PARAMETERS Union wird verwendet, wenn das Feld MajorFunction der FLT_IO_PARAMETER_BLOCK-StrukturIRP_MJ_CREATE_NAMED_PIPE wird.
Syntax
typedef union _FLT_PARAMETERS {
... ;
struct {
PIO_SECURITY_CONTEXT SecurityContext;
ULONG Options;
USHORT POINTER_ALIGNMENT Reserved;
USHORT ShareAccess;
PVOID Parameters;
} CreatePipe;
... ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;
Member
Die CreatePipe-Struktur von FLT_PARAMETERS enthält die folgenden Member.
SecurityContext: Zeiger auf eine IO_SECURITY_CONTEXT-Struktur , die den Sicherheitskontext einer IRP_MJ_CREATE_NAMED_PIPE-Anforderung darstellt, wobei:
Securitycontext->AccessState ist ein Zeiger auf eine ACCESS_STATE-Struktur , die den Betreffkontext des Objekts, gewährte Zugriffstypen und die verbleibenden gewünschten Zugriffstypen enthält.
Securitycontext->DesiredAccess ist eine ACCESS_MASK-Struktur , die die für die Named Pipe angeforderten Zugriffsrechte angibt. Weitere Informationen finden Sie im DesiredAccess-Parameter von FltCreateNamedPipeFile.
Optionen: Bitmaske von Flags, die die Optionen angeben, die beim Erstellen oder Öffnen der Benannten Pipe angewendet werden sollen, sowie die Aktion, die ausgeführt werden soll, wenn die Pipe bereits vorhanden ist. Die niedrigen 24 Bits dieses Members entsprechen dem CreateOptions-Parameter für FltCreateNamedPipeFile. Die hohen 8 Bit entsprechen dem CreateDisposition-Parameter zu FltCreateNamedPipeFile.
Reserviert: Reserviert; nicht verwenden.
ShareAccess: Bitmaske der Für die Named Pipe-Datei angeforderten Freigabezugriffsrechte. Wenn dieser Parameter null ist, wird exklusiver Zugriff angefordert. Weitere Informationen finden Sie im ShareAccess-Parameter für FltCreateNamedPipeFile.
Parameter: Zeiger auf eine NAMED_PIPE_CREATE_PARAMETERS-Struktur , die Informationen zu der Named Pipe enthält, die erstellt oder geöffnet wird.
Hinweise
FLT_PARAMETERS enthält eine CreatePipe-Struktur , wenn der E/A-Vorgang IRP_MJ_CREATE_NAMED_PIPE ist. Der E/A-Vorgang wird durch eine FLT_CALLBACK_DATA-Struktur dargestellt, wobei die Vorgangsparameter in der FLT_IO_PARAMETER_BLOCK-Struktur enthalten sind, auf die der Iopb-Parameter der Rückrufdaten verweist.
Ein Dateisystem-Minifiltertreiber, der eine Rückrufroutine für IRP_MJ_CREATE_NAMED_PIPE-Vorgänge registriert hat, sollte alle erforderlichen Verarbeitungs- und Rückgabevorgänge ausführen.
Beachten Sie, dass die Felder in der CreatePipe-Struktur mit denen für die Create-Struktur übereinstimmen müssen, abgesehen vom letzten Longword-Feld.
IRP_MJ_CREATE_NAMED_PIPE ist ein IRP-basierter Vorgang.
Anforderungen
| Anforderungstyp | Anforderung |
|---|---|
| Header | Fltkernel.h ( fltkernel.h einschließen) |