FltFreeCallbackData 함수(fltkernel.h)

아티클
02/26/2024

FltFreeCallbackData 루틴은 FltAllocateCallbackData 루틴에 의해 할당된 콜백 데이터 구조를 해제합니다.

구문

VOID FLTAPI FltFreeCallbackData(
  [in] PFLT_CALLBACK_DATA CallbackData
);

매개 변수

[in] CallbackData

해제할 콜백 데이터 구조에 대한 포인터입니다. 이 FLT_CALLBACK_DATA 구조체는 FltAllocateCallbackData에 대한 이전 호출에 의해 할당되어야 합니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

반환 값

없음

설명

미니필터 드라이버는 이전에 FltAllocateCallbackData와 함께 할당되고 FltPerformAsynchronousIo 또는 FltPerformSynchronousIo 호출에 사용된 콜백 데이터 구조(FLT_CALLBACK_DATA)에서만 FltFreeCallbackData를 사용해야 합니다.

특히 미니필터 드라이버는 미니필터 드라이버 자체에 의해 할당되지 않은 콜백 데이터 구조에 이 루틴을 사용하면 안 됩니다.

FltFreeCallbackData 루틴은 제공된 CallbackData 개체와 연결된 모든 MDL 체인을 해제합니다. 해당 개체에 대해 FltFreeCallbackData를 호출한 후 FLT_CALLBACK_DATA 개체와 연결된 MDL 체인에 대한 포인터가 유효하지 않습니다.