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 포함) |