FLT_PARAMETERS per l'unione IRP_MJ_SET_INFORMATION

Articolo
02/02/2024

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.