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) | 설정된 경우 파일 시스템은 검색을 위해 QUERY_ON_CREATE_EA_INFORMATION 구조에 EA(확장 특성)를 저장합니다. |
| QoCFileUsnInformation (0x00000008) | 설정된 경우 파일 시스템은 검색을 위해 USN 정보를 QUERY_ON_CREATE_USN_INFORMATION 구조에 저장합니다. |
반환 값
FltRequestFileInfoOnCreateCompletion 은 다음 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_SUCCESS | 파일 시스템에서 요청된 파일 정보를 성공적으로 저장했습니다. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestFileInfoOnCreateCompletion 에서 요청된 파일 정보를 저장할 충분한 메모리를 할당할 수 없습니다. |
| STATUS_INVALID_PARAMETER_2 | 제공된 콜백 데이터 개체가 IRP 기반 만들기 작업이 아닙니다. |
설명
미니필터는 사후 생성 중에 FltRetrieveFileInfoOnCreateCompletionEx 또는 FltRetrieveFileInfoOnCreateCompletion 을 호출하여 파일 정보를 검색할 수 있습니다. 미니필터의 성능은 일반적으로 나중에 파일 정보를 쿼리하는 대신 이러한 방식으로 파일 정보를 요청하고 검색할 때 더 좋습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | fltkernel.h(Fltkernel.h 포함) |