Función FltCreateMailslotFile (fltkernel.h)

Los controladores de minifiltro llaman a FltCreateMailslotFile para crear una canalización o abrir un mailslot existente.

Sintaxis

NTSTATUS FLTAPI FltCreateMailslotFile(
  [in]            PFLT_FILTER               Filter,
  [in, optional]  PFLT_INSTANCE             Instance,
  [out]           PHANDLE                   FileHandle,
  [out, optional] PFILE_OBJECT              *FileObject,
  [in]            ULONG                     DesiredAccess,
  [in]            POBJECT_ATTRIBUTES        ObjectAttributes,
  [out]           PIO_STATUS_BLOCK          IoStatusBlock,
  [in]            ULONG                     CreateOptions,
  [in]            ULONG                     MailslotQuota,
  [in]            ULONG                     MaximumMessageSize,
  [in]            PLARGE_INTEGER            ReadTimeout,
  [in, optional]  PIO_DRIVER_CREATE_CONTEXT DriverContext
);

Parámetros

[in] Filter

Puntero de filtro opaco para el autor de la llamada.

[in, optional] Instance

Puntero de instancia opaco para la instancia del controlador de minifiltro a la que se va a enviar la solicitud de creación. La instancia debe adjuntarse al volumen del sistema de archivos mailslot. Este parámetro es opcional y se puede NULL. Si este parámetro es NULL, la solicitud se envía al objeto de dispositivo en la parte superior de la pila de controladores del sistema de archivos para el volumen. Si no esNULL, la solicitud solo se envía a las instancias del controlador de minifiltro que se adjuntan debajo de la instancia especificada.

[out] FileHandle

Puntero a una variable asignada por el autor de la llamada que recibe el identificador de archivo si la llamada a FltCreateMailslotFile se realiza correctamente.

[out, optional] FileObject

Puntero a una variable asignada por el autor de la llamada que recibe el puntero del objeto de archivo si la llamada a FltCreateMailslotFile se realiza correctamente. Este parámetro es opcional y se puede NULL.

[in] DesiredAccess

Máscara de bits de marcas que especifican el tipo de acceso que requiere el autor de la llamada al archivo o directorio. El conjunto de marcas de DesiredAccess definidas por el sistema determina los siguientes derechos de acceso específicos para los objetos de archivo.

Como alternativa, para cualquier objeto de archivo que no represente un directorio, puede especificar una o varias de las marcas de ACCESS_MASK genéricas siguientes. (Las marcas deXXX STANDARD_RIGHTS_ XXX son valores del sistema predefinidos que se usan para aplicar la seguridad en los objetos del sistema). También puede combinar estas marcas genéricas con marcas adicionales de la tabla anterior.

[in] ObjectAttributes

Puntero a una estructura de OBJECT_ATTRIBUTES opaca que ya se ha inicializado con InitializeObjectAttributes. Si el autor de la llamada se ejecuta en el contexto del proceso del sistema, este parámetro puede ser NULL. De lo contrario, el autor de la llamada debe establecer el atributo OBJ_KERNEL_HANDLE en la llamada a InitializeObjectAttributes. Los miembros de esta estructura para un objeto de archivo se enumeran en la tabla siguiente.

[out] IoStatusBlock

Puntero a una estructura IO_STATUS_BLOCK que recibe el estado de finalización final e información sobre la operación solicitada. Al devolver de fltCreateMailslotFile, el miembro Information de la variable contiene uno de los siguientes valores:

• FILE_CREATED
• FILE_OPENED

[in] CreateOptions

Las opciones que se aplicarán al crear o abrir el mailslot, como una combinación compatible de las marcas siguientes.

[in] MailslotQuota

Tamaño, en bytes, del búfer para escrituras en el mailslot.

[in] MaximumMessageSize

Tamaño máximo, en bytes, de un mensaje que se va a escribir en el mailslot. El valor 0 especifica un mensaje de cualquier tamaño.

[in] ReadTimeout

La hora en que una operación de lectura espera a que un mensaje esté disponible en el mailslot. El tiempo de espera predeterminado se expresa en incrementos de 100 nanosegundos como un entero negativo. Por ejemplo, se especifican 250 milisegundos como –10*1000*250. Además, los valores siguientes tienen significados especiales.

[in, optional] DriverContext

Puntero opcional a una estructura de IO_DRIVER_CREATE_CONTEXT ya inicializada por IoInitializeDriverCreateContext.

Valor devuelto

FltCreateMailslotFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes.

Observaciones

La función fltCreateMailslotFile permite a los controladores de minifiltro crear o abrir instancias de mailslot. Esto resulta útil para crear gráficos de correo virtuales o para crear un grupo de mailslot que se distribuya a varios otros trazados de correo.

El parámetro instancia de es NULL o se establece previamente adjuntando al volumen mailslot. Se obtiene un puntero de volumen pasando "\Device\Mailslot" como nombre de volumen a FltGetVolumeFromName.

Para especificar un parámetro de creación adicional (ECP) como parte de una operación de creación, inicialice el extraCreateParameter miembro de la estructura de IO_DRIVER_CREATE_CONTEXT con la rutina FltAllocateExtraCreateParameterList. Si se usan ECP, deben asignarse, inicializarse y liberarse mediante sus rutinas de soporte técnico asociadas. Al volver de la llamada de FltCreateMailslotFile, la lista ECP no cambia y se puede pasar a llamadas adicionales de FltCreateMailslotFile para otras operaciones de creación. La estructura de la lista ECP no se desasigna automáticamente. El autor de la llamada de FltCreateMailslotFile debe desasignar esta estructura llamando a la rutinafltFreeExtraCreateParameterListFltFreeExtraCreateParameterList.

Si instancia de no es null, la solicitud de creación a partir de FltCreateMailslotFile solo se envía a las instancias adjuntas debajo de la instancia de controlador de minifiltro especificada y al sistema de archivos mailslot. La instancia especificada y las instancias adjuntas anteriormente no reciben la solicitud de creación. Si no se especifica ninguna instancia, la solicitud va a la parte superior de la pila y recibe todas las instancias y el sistema de archivos mailslot.

Requisitos

Consulte también

FltAllocateExtraCreateParameterList

FltFreeExtraCreateParameterList

IO_DRIVER_CREATE_CONTEXT

initializeObjectAttributes

ioInitializeDriverCreateContext