FLT_PARAMETERS para IRP_MJ_CREATE_NAMED_PIPE unión

Artículo
02/07/2024

La siguiente estructura dentro de la unión de FLT_PARAMETERS se usa cuando se IRP_MJ_CREATE_NAMED_PIPE el campo MajorFunction de la estructura FLT_IO_PARAMETER_BLOCK.

Sintaxis

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

Miembros

La estructura CreatePipe de FLT_PARAMETERS contiene los siguientes miembros.

SecurityContext: puntero a una estructura de IO_SECURITY_CONTEXT que representa el contexto de seguridad de una solicitud de IRP_MJ_CREATE_NAMED_PIPE, donde:
SecurityContext:>AccessState es un puntero a una estructura de ACCESS_STATE que contiene el contexto del sujeto del objeto, los tipos de acceso concedidos y los tipos de acceso deseados restantes.
SecurityContext:>DesiredAccess es una estructura ACCESS_MASK que especifica los derechos de acceso solicitados para la canalización con nombre. Para obtener más información, vea el parámetro DesiredAccess de FltCreateNamedPipeFile.
Opciones: máscara de bits de marcas que especifican las opciones que se aplicarán al crear o abrir la canalización con nombre, así como la acción que se realizará si la canalización ya existe. Los 24 bits bajos de este miembro corresponden al parámetro CreateOptions para FltCreateNamedPipeFile. Los 8 bits altos corresponden al parámetro CreateDisposition a FltCreateNamedPipeFile.
Reservado: Reservado; no use.
ShareAccess: máscara de bits de derechos de acceso compartido solicitados para el archivo de canalización con nombre. Si este parámetro es cero, se solicita acceso exclusivo. Para obtener más información, vea el parámetro ShareAccess para FltCreateNamedPipeFile.
Parámetros: puntero a una estructura de NAMED_PIPE_CREATE_PARAMETERS que contiene información sobre la canalización con nombre que se va a crear o abrir.

Comentarios

FLT_PARAMETERS contiene una estructura CreatePipe cuando se IRP_MJ_CREATE_NAMED_PIPE la operación de E/S. La operación de E/S se representa mediante una estructura de FLT_CALLBACK_DATA , con los parámetros de operación incluidos en la estructura de FLT_IO_PARAMETER_BLOCK a la que apunta el parámetro Iopb de los datos de devolución de llamada.

Un minifiltro del sistema de archivos que ha registrado una rutina de devolución de llamada para las operaciones de IRP_MJ_CREATE_NAMED_PIPE debe realizar cualquier procesamiento y devolución necesarios.

Tenga en cuenta que, aparte del último campo longword, los campos de la estructura CreatePipe deben coincidir con los de la estructura Create .

IRP_MJ_CREATE_NAMED_PIPE es una operación basada en IRP.