共用方式為


FltRequestFileInfoOnCreateCompletion 函式 (fltkernel.h)

小型篩選程式會在檔案預先建立期間呼叫 FltRequestFileInfoOnCreateCompletion,要求文件系統在建立後儲存檔案資訊以進行擷取。

語法

NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
  PFLT_FILTER        Filter,
  PFLT_CALLBACK_DATA Data,
  ULONG              InfoClassFlags
);

參數

Filter

可唯一識別迷你篩選驅動程式的不透明篩選指標。

Data

代表 I/O 建立作業之 FLT_CALLBACK_DATA 回呼數據的指標。

InfoClassFlags

旗標位掩碼,指出文件系統在建立期間應儲存的檔案信息類型,以供擷取。 可以是下列旗標的任何組合:

意義
QoCFileStatInformation (0x00000001) 如果設定,文件系統會將檔案統計數據資訊儲存在 QUERY_ON_CREATE_FILE_STAT_INFORMATION 結構中以供擷取。
QoCFileLxInformation (0x00000002) 如果設定,文件系統會將擴充的類似 Linux 的資訊儲存在 QUERY_ON_CREATE_FILE_LX_INFORMATION 結構中,以供擷取。
QoCFileEaInformation (0x00000004) 如果設定,文件系統會將擴充屬性 (EA) 儲存在 QUERY_ON_CREATE_EA_INFORMATION 結構中以供擷取。
QoCFileUsnInformation (0x00000008) 如果設定,文件系統會將USN資訊儲存在 QUERY_ON_CREATE_USN_INFORMATION 結構中以供擷取。

傳回值

FltRequestFileInfoOnCreateCompletion 可以傳回下列其中一個值:

傳回碼 描述
STATUS_SUCCESS 檔系統已成功儲存要求的檔案資訊。
STATUS_INSUFFICIENT_RESOURCES FltRequestFileInfoOnCreateCompletion 無法配置足夠的記憶體來儲存要求的檔案資訊。
STATUS_INVALID_PARAMETER_2 提供的回呼數據物件不是以 IRP 為基礎的建立作業。

言論

minifilter 可以呼叫 FltRetrieveFileInfoOnCreateCompletionExFltRetrieveFileInfoOnCreateCompletion 來擷取檔案資訊。 小型篩選程式的效能通常會在要求和擷取以這種方式擷取檔案資訊時更好,而不是稍後查詢檔案資訊。

要求

要求 價值
標頭 fltkernel.h (包括 Fltkernel.h)

另請參閱

FLT_CALLBACK_DATA

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx