PMRX_IS_LOCK_REALIZABLE コールバック関数 (mrx.h)

[アーティクル]
10/13/2023

MRxIsLockRealizable ルーチンは RDBSS によって呼び出され、ネットワークミニリダイレクターがこのNET_ROOT構造体で特定のバイト範囲ロックがサポートされているかどうかを示すように要求します。

構文

PMRX_IS_LOCK_REALIZABLE PmrxIsLockRealizable;

NTSTATUS PmrxIsLockRealizable(
  IN OUT PMRX_FCB Fcb,
  IN PLARGE_INTEGER ByteOffset,
  IN PLARGE_INTEGER Length,
  IN ULONG LowIoLockFlags
)
{...}

パラメーター

Fcb

[入力、出力]FCB 構造体へのポインター。

ByteOffset

[入力]バイト範囲ロックのバイトオフセットを示す値。

Length

[入力]バイト範囲ロックの長さを示す値。

LowIoLockFlags

[入力]I/O ロックフラグを示すビットマスクを持つ値。

戻り値

MRxIsLockRealizable は、成功したSTATUS_SUCCESS、または次のような適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_NOT_SUPPORTED	要求されたバイト範囲ロックはサポートされていません。ネットワークミニリダイレクターは、他の種類のバイト範囲ロックがサポートされている場合でもサポートされていないロック要求に対してこの値を返します。サポートされていないロックには、64 ビットロック (ByteOffset-HighPart> メンバーが 0 以外)、長さ 0 のロック (Length パラメーターが 0)、または共有ロック (LowIoLockFlags パラメーターのLOWIO_LOCKSFLAG_EXCLUSIVELOCK ビットが設定されていない) が含まれる場合があります。

リターンコード

説明

STATUS_NOT_SUPPORTED

要求されたバイト範囲ロックはサポートされていません。ネットワークミニリダイレクターは、他の種類のバイト範囲ロックがサポートされている場合でもサポートされていないロック要求に対してこの値を返します。サポートされていないロックには、64 ビットロック (ByteOffset-HighPart> メンバーが 0 以外)、長さ 0 のロック (Length パラメーターが 0)、または共有ロック (LowIoLockFlags パラメーターのLOWIO_LOCKSFLAG_EXCLUSIVELOCK ビットが設定されていない) が含まれる場合があります。

注釈

MRxIsLockRealizable は、要求された特定のバイト範囲ロックがこのNET_ROOT構造体でサポートされているかどうかを判断します。ネットワークミニリダイレクターは、特定のバイト範囲ロックをサポートし、他のバイト範囲ロックをサポートしていない場合があります。たとえば、ネットワークミニリダイレクターでは、32 ビットバイト範囲ロックまたは排他ロックのみがサポートされる場合があります。

MRxIsLockRealizable は、IRP_MN_LOCKマイナー関数を使用して IRP を受信するために呼び出されます。