FltPerformSynchronousIo 함수(fltkernel.h)

아티클
08/07/2023

미니필터 드라이버는 FltPerformSynchronousIo 를 호출하여 FltAllocateCallbackData 를 호출하여 작업에 대한 콜백 데이터 구조를 할당한 후 동기 I/O 작업을 시작합니다.

구문

VOID FLTAPI FltPerformSynchronousIo(
  [in, out] PFLT_CALLBACK_DATA CallbackData
);

매개 변수

[in, out] CallbackData

FltAllocateCallbackData에 대한 이전 호출에 의해 할당된 콜백 데이터(FLT_CALLBACK_DATA) 구조체에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다. 호출자는 FltFreeCallbackData를 호출하여 더 이상 필요하지 않은 경우 이 구조를 해제할 책임이 있습니다.

반환 값

없음

설명

미니필터 드라이버는 FltPerformSynchronousIo 를 호출하여 동기 I/O 작업을 시작합니다.

미니필터 드라이버는 IRP 기반 I/O 작업만 시작할 수 있습니다. 빠른 I/O 또는 FSFilter(파일 시스템 필터) 콜백 작업을 시작할 수 없습니다.

FltPerformSynchronousIo는 시작 instance 아래에 연결된 미니필터 드라이버 인스턴스(FltAllocateCallbackData에 인스턴스 매개 변수에 지정됨) 및 파일 시스템에만 I/O 작업을 보냅니다. 지정된 instance 위에 연결된 미니필터 드라이버는 I/O 작업을 받지 않습니다.

미니필터 드라이버는 다음과 같은 루틴을 사용할 수 없는 경우에만 FltPerformSynchronousIo 를 사용해야 합니다.

FltClose

FltCreateFile

FltQueryInformationFile

FltQueryVolumeInformation

FltReadFile

FltSetInformationFile

FltSetVolumeInformation

FltTagFile

FltUntagFile

FltWriteFile

FltPerformSynchronousIo가 반환된 후 호출자는 FltReissueSynchronousIo를 호출하여 I/O 작업을 다시 실행할 수 있습니다. 또는 호출자는 FltFreeCallbackData를 호출하여 콜백 데이터(FLT_CALLBACK_DATA) 구조를 해제하거나 FltReuseCallbackData를 호출하여 다시 사용하도록 준비할 수 있습니다.