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 可以呼叫 FltRetrieveFileInfoOnCreateCompletionEx 或 FltRetrieveFileInfoOnCreateCompletion 來擷取檔案資訊。 小型篩選程式的效能通常會在要求和擷取以這種方式擷取檔案資訊時更好,而不是稍後查詢檔案資訊。
要求
要求 | 價值 |
---|---|
標頭 | fltkernel.h (包括 Fltkernel.h) |