FLT_PARAMETERS для объединения IRP_MJ_CREATE_NAMED_PIPE

Статья
03/14/2023

Следующая структура в FLT_PARAMETERS объединении используется, когда поле MajorFunction структуры FLT_IO_PARAMETER_BLOCK IRP_MJ_CREATE_NAMED_PIPE.

Синтаксис

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

Члены

Структура CreatePipe FLT_PARAMETERS содержит следующие элементы.

SecurityContext: указатель на структуру IO_SECURITY_CONTEXT , представляющую контекст безопасности запроса IRP_MJ_CREATE_NAMED_PIPE, где:
SecurityContext->AccessState — это указатель на структуру ACCESS_STATE , которая содержит контекст субъекта объекта, предоставленные типы доступа и остальные требуемые типы доступа.
SecurityContext->DesiredAccess — это структура ACCESS_MASK , указывающая права доступа, запрашиваемые для именованного канала. Дополнительные сведения см. в разделе Параметр DesiredAccessобъекта FltCreateNamedPipeFile.
Параметры: битовая маска флагов, которые указывают параметры, применяемые при создании или открытии именованного канала, а также действия, которые необходимо выполнить, если канал уже существует. Низкие 24 бита этого элемента соответствуют параметру CreateOptions для FltCreateNamedPipeFile. Высокие 8 бит соответствуют параметру CreateDisposition значения FltCreateNamedPipeFile.
Зарезервировано: зарезервировано; не использовать.
ShareAccess: битовая маска прав доступа к общей папке, запрошенных для файла именованного канала. Если этот параметр равен нулю, запрашивается монопольный доступ. Дополнительные сведения см. в разделе Параметр ShareAccess для FltCreateNamedPipeFile.
Параметры: указатель на структуру NAMED_PIPE_CREATE_PARAMETERS , содержащую сведения о создаваемом или открываемом именованном канале.

FLT_PARAMETERS содержит структуру CreatePipe , когда операция ввода-вывода IRP_MJ_CREATE_NAMED_PIPE. Операция ввода-вывода представлена структурой FLT_CALLBACK_DATA с параметрами операции, содержащимися в структуре FLT_IO_PARAMETER_BLOCK , на которую указывает параметр Iopb данных обратного вызова.

Драйвер минифильтра файловой системы, который зарегистрировал подпрограмму обратного вызова для IRP_MJ_CREATE_NAMED_PIPE операций, должен выполнять необходимую обработку и возврат.

Обратите внимание, что поля в структуре CreatePipe не должны совпадать с полями, указанными в структуре Create .

IRP_MJ_CREATE_NAMED_PIPE — это операция на основе IRP.