FSCTL_OPBATCH_ACK_CLOSE_PENDING 제어 코드

아티클
02/12/2024

FSCTL_OPBATCH_ACK_CLOSE_PENDING 제어 코드는 파일의 배타적(수준 1, 일괄 처리 또는 필터) 기회 잠금(oplock)이 끊어졌다는 알림에 응답합니다. 클라이언트 애플리케이션은 이 컨트롤 코드를 보내 oplock 중단을 승인하고 파일 핸들을 닫을 것임을 나타냅니다.

일괄 처리 또는 필터 오프록 중단의 경우 호출자는 이 제어 코드를 보낸 후 파일 핸들을 닫아야 합니다. 그렇지 않으면 시스템에서 파일 핸들이 닫힘을 기다리는 것을 차단합니다.

이 컨트롤 코드는 수준 1 oplock과 함께 사용할 수 없습니다. 그럼에도 불구하고 수준 1 oplock 중단의 경우 시스템은 이 컨트롤 코드를 중단에 대한 완전한 승인으로 처리하며 호출자는 파일 핸들을 닫을 필요가 없습니다.

이 컨트롤 코드는 거의 사용되지 않습니다. 클라이언트 애플리케이션이 파일에 대한 oplock 중단 알림을 받고 파일에 대한 핸들을 닫으면 시스템은 파일 핸들을 닫아 oplock 중단에 대한 완전한 승인으로 처리합니다. 따라서 이 제어 코드를 보낼 필요가 없습니다.

이 제어 코드를 처리하기 위해 미니필터는 다음 매개 변수를 사용하여 FltOplockFsctrl 을 호출합니다. 파일 시스템 또는 레거시 필터 드라이버는 FsRtlOplockFsctrl을 호출합니다.

기회 잠금 및 FSCTL_OPBATCH_ACK_CLOSE_PENDING 제어 코드에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

매개 변수

Oplock: 파일에 대한 불투명 불투명 개체 포인터입니다.
CallbackData: FltOplockFsctrl 만 해당합니다. IRP_MJ_FILE_SYSTEM_CONTROL FSCTL 요청에 대한 콜백 데이터(FLT_CALLBACK_DATA) 구조입니다. 작업에 대한 FsControlCode 매개 변수는 FSCTL_OPBATCH_ACK_CLOSE_PENDING 합니다.
Irp: FsRtlOplockFsctrl 만 해당합니다. IRP_MJ_FILE_SYSTEM_CONTROL FSCTL 요청에 대한 IRP입니다. 작업에 대한 FsControlCode 매개 변수는 FSCTL_OPBATCH_ACK_CLOSE_PENDING 합니다.
OpenCount: 이 작업에 사용되지 않습니다. 를 0으로 설정합니다.

상태 블록

FltOplockFsctrl은 항상 이 작업에 대한 FLT_PREOP_COMPLETE 반환합니다.

FsRtlOplockFsctrl 은 이 작업에 대해 다음 NTSTATUS 값 중 하나를 반환합니다.

코드	의미
STATUS_SUCCESS	이 핸들에 의해 유지된 oplock은 부서지는 중이었습니다.
STATUS_INVALID_OPLOCK_PROTOCOL	이 핸들에서 oplock을 유지하지 않았거나 oplock 중단이 현재 진행 중이 아닙니다. 오류 코드입니다.