FLT_PARAMETERS untuk serikat IRP_MJ_SET_INFORMATION

Artikel
04/13/2023

Komponen union yang digunakan ketika bidang MajorFunction dari struktur FLT_IO_PARAMETER_BLOCK untuk operasi IRP_MJ_SET_INFORMATION.

Sintaks

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;

Anggota

SetFileInformation: Struktur yang berisi anggota berikut.
Panjang: Panjang, dalam byte, buffer di InfoBuffer.

FileInformationClass: Jenis informasi yang akan diatur untuk file. Salah satu dari berikut ini:

Nilai	Makna
FileAllocationInformation	Atur FILE_ALLOCATION_INFORMATION untuk file.
FileBasicInformation	Atur FILE_BASIC_INFORMATION untuk file.
FileDispositionInformation	Atur FILE_DISPOSITION_INFORMATION untuk file.
FileEndOfFileInformation	Atur FILE_END_OF_FILE_INFORMATION untuk file.
FileLinkInformation	Atur FILE_LINK_INFORMATION untuk file.
FilePositionInformation	Atur FILE_POSITION_INFORMATION untuk file.
FileRenameInformation	Atur FILE_RENAME_INFORMATION untuk file.
FileValidDataLengthInformation	Atur FILE_VALID_DATA_LENGTH_INFORMATION untuk file.

ParentOfTarget: Untuk mengganti nama atau menautkan operasi. Jika InfoBuffer-FileName> berisi nama file yang sepenuhnya memenuhi syarat, atau jika InfoBuffer-RootDirectory>non-NULL, anggota ini adalah penunjuk objek file untuk direktori induk file yang merupakan target operasi. Jika tidak, null.
( struct yang tidak disebutkan namanya )
Struktur yang berisi anggota berikut.
ReplaceIfExists: Untuk mengganti nama atau menautkan operasi. Atur ke TRUE untuk menentukan bahwa file yang sudah ada dengan nama yang sama akan diganti dengan file yang diberikan. Atur ke FALSE jika operasi ganti nama atau tautan harus gagal jika file dengan nama yang diberikan sudah ada.
AdvanceOnly: Bendera untuk operasi akhir file. Ini menentukan penggunaan anggota EndOfFileFILE_END_OF_FILE_INFORMATION struktur ketika FileInformationClass == FileEndOfFileInformation. Jika TRUE, panjang data baru yang valid untuk file akan diatur dari EndOfFile hanya jika meningkatkan panjang data yang valid saat ini. Jika FALSE, ukuran file baru diatur dari EndOfFile.
ClusterCount: Dicadangkan untuk penggunaan sistem. Jangan gunakan.
DeleteHandle: Dicadangkan untuk penggunaan sistem. Jangan gunakan.
InfoBuffer: Penunjuk ke buffer input yang berisi informasi file yang akan diatur.

Keterangan

Struktur FLT_PARAMETERS untuk operasi IRP_MJ_SET_INFORMATION berisi parameter untuk operasi set-information yang diwakili oleh struktur data panggilan balik (FLT_CALLBACK_DATA). Ini terkandung dalam struktur FLT_IO_PARAMETER_BLOCK.

IRP_MJ_SET_INFORMATION adalah operasi berbasis IRP.

Anggota AdvanceOnly diatur ke TRUE oleh manajer cache untuk memberi tahu sistem file untuk memajukan panjang data yang valid saat ini pada disk ke panjang data baru yang valid di EndOfFile. Jika AdvanceOnlyFALSE, ukuran file baru, di anggota EndOfFile , sedang diatur yang bisa lebih besar atau lebih kecil dari ukuran file saat ini.