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結構中以供擷取。

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

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

minifilter 可以在建立後呼叫 FltRetrieveFileInfoOnCreateCompletionEx 或 FltRetrieveFileInfoOnCreateCompletion 來擷取檔案資訊。迷你篩選的效能通常比較好，因為它會以這種方式要求和擷取檔案資訊，而不是稍後查詢檔案資訊。

需求	值
標頭	fltkernel.h (包含 Fltkernel.h)