PCOMPLETE_LOCK_IRP_ROUTINE コールバック関数 (ntifs.h)
ファイル システム フィルター ドライバー (レガシ フィルター) は、フィルターの CompleteLockIrpRoutine コールバックとしてPCOMPLETE_LOCK_IRP_ROUTINE型指定されたルーチンを登録できます。
構文
PCOMPLETE_LOCK_IRP_ROUTINE PcompleteLockIrpRoutine;
NTSTATUS PcompleteLockIrpRoutine(
PVOID Context,
PIRP Irp
)
{...}
パラメーター
Context
[入力] FsRtlProcessFileLock に渡されたコンテキスト ポインター。
Irp
[入力]ファイル ロックの IRP IRP_MJ_LOCK_CONTROL 完了している要求です。 ロック要求の種類は、次のいずれかになります。
- IRP_MN_LOCK
- IRP_MN_UNLOCK_ALL
- IRP_MN_UNLOCK_ALL_BY_KEY
- IRP_MN_UNLOCK_SINGLE
戻り値
このルーチンは、STATUS_SUCCESSまたは適切な NTSTATUS 値を返します。 成功コードではない NTSTATUS 値が返された場合、ファイル ロックはファイルから削除されます。
注釈
ファイル システム フィルター ドライバー (レガシ フィルター) は、必要に応じて、バイト範囲ファイル ロックのレガシ フィルターの CompleteLockIrpRoutine ルーチンとして、PCOMPLETE_LOCK_IRP_ROUTINE型指定されたルーチンを指定できます。
このルーチンを指定するために、レガシ フィルターは、FsRtlAllocateFileLock または FsRtlInitializeFileLock の CompleteLockIrpRoutine パラメーターとしてルーチンへのポインターを渡します。
レガシ フィルターでファイル ロックの CompleteLockIrpRoutine ルーチンが指定されている場合、システムはファイル ロックの IRP_MJ_LOCK_CONTROL 操作を完了するときにこのルーチンを呼び出します。
要件
| 要件 | 値 |
|---|---|
| Header | ntifs.h |
| IRQL | APC_LEVEL |