FltCbdqDisable 함수(fltkernel.h)

아티클
08/07/2023

FltCbdqDisable 은 미니필터 드라이버의 콜백 데이터 큐를 사용하지 않도록 설정합니다.

구문

VOID FLTAPI FltCbdqDisable(
  [in, out] PFLT_CALLBACK_DATA_QUEUE Cbdq
);

매개 변수

[in, out] Cbdq

콜백 데이터 큐에 대한 포인터입니다.

반환 값

없음

설명

FltCbdqDisable 은 더 이상 항목을 추가할 수 없도록 콜백 데이터 큐를 사용하지 않도록 설정합니다.

미니필터 드라이버는 FltCbdqXxx 루틴을 사용하여 IRP 기반 I/O 작업에 대한 콜백 데이터 큐를 구현할 수 있습니다. 미니필터 드라이버는 이러한 루틴을 사용하여 큐를 취소로부터 안전하게 만들 수 있습니다. 시스템은 미니필터 드라이버에 대한 I/O 취소를 투명하게 처리합니다.

FltCbdqXxx 루틴은 IRP 기반 I/O 작업에만 사용할 수 있습니다. 지정된 콜백 데이터 구조가 IRP 기반 I/O 작업을 나타내는지 여부를 확인하려면 FLT_IS_IRP_OPERATION 매크로를 사용합니다.

미니필터 드라이버는 일반적으로 instance 중단 또는 미니필터 드라이버 언로드 중에 FltCbdqDisable을 호출합니다. 이 루틴을 호출한 후 미니필터 드라이버는 큐를 비우거나 드레이닝해야 합니다. 이 작업은 더 이상 항목이 큐에 남아 있지 않을 때까지 FltCbdqRemoveNextIo 를 반복적으로 호출하여 수행할 수 있습니다.

콜백 데이터 큐를 만드는 방법에 대한 자세한 내용은 FltCbdqInitialize 를 참조하세요. FltCbdqInsertIo를 사용하여 큐에 I/O 요청을 추가합니다. FltCbdqRemoveIo를 사용하여 큐에서 특정 I/O 요청을 제거하거나 FltCbdqRemoveNextIo를 사용하여 사용 가능한 다음 I/O 요청을 제거합니다.

큐를 사용하지 않도록 설정하면 큐를 다시 사용하도록 설정하려면 FltCbdqEnable을 호출합니다.

큐가 뮤텍스 개체 또는 리소스 변수가 아닌 스핀 잠금으로 보호되는 경우 FltCbdqDisable의 호출자는 IRQL <= DISPATCH_LEVEL 실행할 수 있습니다. 뮤텍스 또는 리소스를 사용하는 경우 호출자는 IRQL <= APC_LEVEL 실행되어야 합니다.