PUNLOCK_ROUTINE コールバック関数 (ntifs.h)

フィルター (レガシフィルターまたはミニフィルター) は、PUNLOCK_ROUTINE型指定のルーチンを、FILE_LOCK構造体のフィルターの UnlockRoutine コールバックルーチンとして登録できます。

構文

PUNLOCK_ROUTINE PunlockRoutine;

void PunlockRoutine(
  PVOID Context,
  PFILE_LOCK_INFO FileLockInfo
)
{...}

Context

[入力] FltProcessFileLock または FsRtlProcessFileLock に渡されたコンテキストポインター。

FileLockInfo

バイト範囲ロックの FILE_LOCK_INFO 構造体への不透明なポインター。

なし

フィルター (レガシフィルターまたはミニフィルター) では、必要に応じて、バイト範囲ファイルロックのフィルターの UnlockRoutine コールバックとして、PUNLOCK_ROUTINE型指定されたルーチンを指定できます。

フィルターでFILE_LOCK構造体の UnlockRoutine ルーチンが指定されている場合、ファイル内のロックされたバイト範囲からロックが削除されると、このルーチンが呼び出されます。

ミニフィルターは、FltAllocateFileLock の UnlockRoutine パラメーターとしてルーチンへのポインターを渡すことによって、このルーチンを指定します。

レガシフィルターは、FsRtlAllocateFileLock または FsRtlInitializeFileLock の UnlockRoutine パラメーターとしてルーチンへのポインターを渡すことによって、このルーチンを指定します。

要件	値
Header	ntifs.h
IRQL	IRQL <= APC_LEVEL