FSCTL_OPLOCK_BREAK_ACK_NO_2 制御コード

FSCTL_OPLOCK_BREAK_ACK_NO_2 制御コードは、ファイルに対する排他的な (レベル 1、バッチまたはフィルター) 便宜的ロック (oplock) が解除されたことを示す通知に応答します。

クライアントアプリケーションは、この制御コードを送信することによって、oplock の解除を確認したことと、oplock がレベル 1 oplock でかつそれが解除されてレベル 2 になる場合は、レベル 2 oplock が必要ないことを示します。

この制御コードを処理するために、ミニフィルターが次のパラメーターを指定して FltOplockFsctrl を呼び出します。ファイルシステムまたはレガシフィルタードライバーによって FsRtlOplockFsctrl が呼び出されます。

便宜的ロックと FSCTL_OPLOCK_BREAK_ACK_NO_2 制御コードの詳細については、Microsoft Windows SDK のドキュメントを参照してください。

パラメーター

Oplock: ファイルの不透明な oplock オブジェクトポインター。
CallbackData: FltOplockFsctrl のみ。 IRP_MJ_FILE_SYSTEM_CONTROL FSCTL 要求のコールバックデータ (FLT_CALLBACK_DATA) 構造体。操作の FsControlCode パラメーターは FSCTL_OPLOCK_BREAK_ACK_NO_2 である必要があります。
Irp: FsRtlOplockFsctrl のみ。 IRP_MJ_FILE_SYSTEM_CONTROL FSCTL 要求の IRP。操作の FsControlCode パラメーターは FSCTL_OPLOCK_BREAK_ACK_NO_2 である必要があります。
OpenCount: この操作では使用されません。0 に設定します。

FltOplockFsctrl は常に、この操作に対して FLT_PREOP_COMPLETE を返します。

FsRtlOplockFsctrl はこの操作に対して次のいずれかの NTSTATUS 値を返します。

コード	意味
STATUS_SUCCESS	oplock の解除が確認されます。残りの oplock は保持されます。
STATUS_INVALID_OPLOCK_PROTOCOL	このハンドルによって oplock が保持されていなかったか、oplock の解除が現在進行中ではありません。これはエラーコードです。

要件タイプ	要件
ヘッダー	Ntifs.h (Ntifs.h または Fltkernel.h を含む)