FLT_PARAMETERS para la unión de IRP_MJ_CREATE_MAILSLOT

Artículo
03/14/2023

La siguiente estructura dentro de la unión FLT_PARAMETERS se usa cuando se IRP_MJ_CREATE_MAILSLOT 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;
  } CreateMailslot;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Miembros

La estructura CreateMailslot 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_MAILSLOT, 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 de ACCESS_MASK que especifica los derechos de acceso solicitados para el mailslot. Para obtener más información, vea el parámetro DesiredAccess de FltCreateMailslotFile.
Opciones: máscara de bits de marcas que especifican las opciones que se van a aplicar al crear o abrir el mailslot, así como la acción que se debe realizar si el mailslot ya existe. Los 24 bits bajos de este miembro corresponden al parámetro CreateOptions para FltCreateMailslotFile. Los 8 bits altos corresponden al parámetro CreateDisposition para FltCreateMailslotFile.
Reservado: Reservado; no use.
ShareAccess: máscara de bits de los derechos de acceso a recursos compartidos solicitados para el archivo mailslot. Si este parámetro es cero, se solicita acceso exclusivo. Para obtener más información, vea el parámetro ShareAccess para FltCreateMailslotFile.
Parámetros: puntero a una estructura de MAILSLOT_CREATE_PARAMETERS que contiene información sobre el mailslot que se va a crear o abrir.

Comentarios

FLT_PARAMETERS contiene una estructura CreateMailslot cuando se IRP_MJ_CREATE_MAILSLOT 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 contenidos en la estructura FLT_IO_PARAMETER_BLOCK a la que apunta el parámetro Iopb de los datos de devolución de llamada.

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

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

IRP_MJ_CREATE_MAILSLOT es una operación basada en IRP.