Condividi tramite


FLT_PARAMETERS per l'unione IRP_MJ_SET_INFORMATION

Componente unione usato quando il campo MajorFunction della struttura FLT_IO_PARAMETER_BLOCK per l'operazione è IRP_MJ_SET_INFORMATION.

Sintassi

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    ULONG                                    Length;
    FILE_INFORMATION_CLASS POINTER_ALIGNMENT FileInformationClass;
    PFILE_OBJECT                             ParentOfTarget;
    union {
      struct {
        BOOLEAN ReplaceIfExists;
        BOOLEAN AdvanceOnly;
      };
      ULONG  ClusterCount;
      HANDLE DeleteHandle;
    };
    PVOID                                    InfoBuffer;
  } SetFileInformation;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Members

  • SetFileInformation: struttura contenente i membri seguenti.

  • Lunghezza: lunghezza, in byte, del buffer in InfoBuffer.

  • FileInformationClass: tipo di informazioni da impostare per il file. I tipi validi sono:

    Valore Significato
    FileAllocationInformation Impostare FILE_ALLOCATION_INFORMATION per il file.
    FileBasicInformation Impostare FILE_BASIC_INFORMATION per il file.
    FileDispositionInformation Impostare FILE_DISPOSITION_INFORMATION per il file.
    FileEndOfFileInformation Impostare FILE_END_OF_FILE_INFORMATION per il file.
    FileLinkInformation Impostare FILE_LINK_INFORMATION per il file.
    FilePositionInformation Impostare FILE_POSITION_INFORMATION per il file.
    FileRenameInformation Impostare FILE_RENAME_INFORMATION per il file.
    FileValidDataLengthInformation Impostare FILE_VALID_DATA_LENGTH_INFORMATION per il file.
  • ParentOfTarget: per le operazioni di ridenominazione o collegamento. Se InfoBuffer-FileName contiene un nome file completo o se InfoBuffer-RootDirectory>> non è NULL, questo membro è un puntatore a oggetti file per la directory padre del file di destinazione dell'operazione. In caso contrario, è NULL.

  • ( struct senza nome )
    Struttura contenente i membri seguenti.

  • ReplaceIfExists: per le operazioni di ridenominazione o collegamento. Impostare su TRUE per specificare che un file già esistente con lo stesso nome deve essere sostituito con il file specificato. Impostare su FALSE se l'operazione di ridenominazione o collegamento deve avere esito negativo se esiste già un file con il nome specificato.

  • AdvanceOnly: flag per le operazioni end-of-file. Ciò determina l'uso della struttura del membro EndOfFileFILE_END_OF_FILE_INFORMATION quando FileInformationClass == FileEndOfFileInformation. Se TRUE, una nuova lunghezza di dati valida per il file verrà impostata da EndOfFile solo se aumenta la lunghezza dei dati valida corrente. Se FALSE, viene impostata una nuova dimensione del file da EndOfFile.

  • ClusterCount: riservato per l'uso del sistema. Non usare.

  • DeleteHandle: riservato per l'uso del sistema. Non usare.

  • InfoBuffer: puntatore a un buffer di input contenente le informazioni sui file da impostare.

Commenti

La struttura FLT_PARAMETERS per le operazioni IRP_MJ_SET_INFORMATION contiene i parametri per un'operazione set-information rappresentata da una struttura di callback (FLT_CALLBACK_DATA). È contenuta in una struttura di FLT_IO_PARAMETER_BLOCK.

IRP_MJ_SET_INFORMATION è un'operazione basata su IRP.

Il membro AdvanceOnly è impostato su TRUE dalla gestione cache per notificare al file system l'avanzamento della lunghezza dei dati valida corrente nel disco alla nuova lunghezza dei dati valida in EndOfFile. Se AdvanceOnly è FALSE, viene impostata una nuova dimensione del file, nel membro EndOfFile , che può essere maggiore o minore delle dimensioni correnti del file.

Requisiti

Tipo di requisito Requisito
Intestazione Fltkernel.h (include Fltkernel.h)

Vedi anche

FILE_ALLOCATION_INFORMATION

FILE_BASIC_INFORMATION

FILE_DISPOSITION_INFORMATION

FILE_END_OF_FILE_INFORMATION

FILE_LINK_INFORMATION

FILE_POSITION_INFORMATION

FILE_RENAME_INFORMATION

FILE_VALID_DATA_LENGTH_INFORMATION

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FLT_IS_FASTIO_OPERATION

FLT_IS_FS_FILTER_OPERATION

FLT_IS_IRP_OPERATION

FLT_PARAMETERS

IRP_MJ_SET_INFORMATION