FsRtlOplockFsctrl 函式 (ntifs.h)
FsRtlOplockFsctrl 代表文件系統或篩選驅動程式執行各種作業 (oplock) 作業。
語法
NTSTATUS FsRtlOplockFsctrl(
[in] POPLOCK Oplock,
[in] PIRP Irp,
[in] ULONG OpenCount
);
參數
[in] Oplock
檔案的不透明不透明指標。 此指標必須由 先前對 FsRtlInitializeOplock 的呼叫初始化。
[in] Irp
I/O 作業的 IRP 指標。 這個參數是必要的,而且不能是 NULL。
[in] OpenCount
如果要求獨佔的 oplock,檔案的使用者句柄數目。 設定層級 2、R 或 RH oplock 要求的非零值表示檔案上有位元組範圍鎖定。 如需 oplock 類型的相關信息,請參閱 Oplock 概觀。
傳回值
FsRtlOplockFsctrl 會傳回下列其中一個 NTSTATUS 值:
傳回碼 | Description |
---|---|
STATUS_SUCCESS | 對於IRP_MJ_CREATE要求,STATUS_SUCCESS表示已授與要求的篩選作業鎖定。 針對 FSCTL 作業,STATUS_SUCCESS的意義取決於 FSCTL 程式代碼。 如需詳細資訊,請參閱下列一節中列出的 FSCTL 代碼參考頁面。 |
STATUS_CANCELLED | I/O 作業已取消。 STATUS_CANCELLED是錯誤碼。 |
STATUS_INVALID_PARAMETER | I/O 作業的 FSCTL 程式代碼不是下列一節所列的有效值之一。 STATUS_INVALID_PARAMETER是錯誤碼。 |
STATUS_OPLOCK_NOT_GRANTED | 無法授與 oplock。 STATUS_OPLOCK_NOT_GRANTED是錯誤碼。 |
STATUS_PENDING | 僅適用於 FSCTL 作業。 STATUS_PENDING的意義取決於 FSCTL 程式代碼。 如需詳細資訊,請參閱下列一節中列出的 FSCTL 代碼參考頁面。 STATUS_PENDING是成功的程序代碼。 |
STATUS_CANNOT_BREAK_OPLOCK | 無法授與新的 oplock。 IRP 是IRP_MJ_CREATE要求,FILE_OPEN_REQUIRING_OPLOCK是在作業的 create options 參數中指定。 STATUS_CANNOT_BREAK_OPLOCK是成功的程序代碼。 |
備註
文件系統和舊版篩選驅動程式會呼叫 FsRtlOplockFsctrl ,以針對建立或文件系統控制 I/O 作業執行各種 oplock 作業。 Minifilters 應該呼叫 FltOplockFsctrl ,而不是 FsRtlOplockFsctrl。
Irp 參數所指向的 IRP 必須是IRP_MJ_FILE_SYSTEM_CONTROL或IRP_MJ_CREATE作業的有效 IRP。
如果 IRP 是IRP_MJ_FILE_SYSTEM_CONTROL要求,FsRtlOplockFsctrl 可以搭配下列其中一個 FSCTL 程式代碼使用,此程式代碼是在 IrpSp-Parameters.FileSystemControl.FsControlCode> 中設定:
- FSCTL_OPBATCH_ACK_CLOSE_PENDING
- FSCTL_OPLOCK_BREAK_ACK_NO_2
- FSCTL_OPLOCK_BREAK_ACKNOWLEDGE
- FSCTL_OPLOCK_BREAK_NOTIFY
- FSCTL_REQUEST_BATCH_OPLOCK
- FSCTL_REQUEST_FILTER_OPLOCK
- FSCTL_REQUEST_OPLOCK_LEVEL_1
- FSCTL_REQUEST_OPLOCK_LEVEL_2
如需這些 FSCTL 和一般操作鎖定的詳細資訊,請參閱 Microsoft Windows SDK 檔。
如果 IRP 是 IRP_MJ_CREATE 要求,如果下列所有條件都成立, FsRtlOplockFsctrl 可用來要求擱置的篩選 oplock:
- OpenCount 參數的值必須是 1。
- IRP_MJ_CREATE要求的 DesiredAccess 參數值必須FILE_READ_ATTRIBUTES。
- IRP_MJ_CREATE要求的 ShareAccess 參數值必須FILE_SHARE_READ |FILE_SHARE_WRITE |FILE_SHARE_DELETE。
如果授與擱置篩選作業鎖定的要求, FsRtlOplockFsctrl 會傳回STATUS_SUCCESS。 如需建立參數的詳細資訊,請參閱 IRP_MJ_CREATE的參考專案。
呼叫此函式的篩選和文件系統必須將呼叫同步處理至系統提供的 oplock 套件。 如需詳細資訊 ,請參閱 Oplock 同步 處理。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | ntifs.h (包含 Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
另請參閱
FSCTL_OPBATCH_ACK_CLOSE_PENDING
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應