FltAcquirePushLockShared 関数 (fltkernel.h)

[アーティクル]
08/07/2023

FltAcquirePushLockShared ルーチンは、呼び出し元のスレッドによる共有アクセスに対して、指定されたプッシュロックを取得します。

構文

VOID FLTAPI FltAcquirePushLockShared(
  [in, out] PEX_PUSH_LOCK PushLock
);

パラメーター

[in, out] PushLock

PEX_PUSH_LOCK型の不透明なプッシュロックポインター。このポインターは、 FltInitializePushLock の以前の呼び出しによって初期化されている必要があります。

戻り値

[なし] :

解説

FltAcquirePushLockShared ルーチンは、呼び出し元のスレッドによる共有アクセスに対して、指定されたプッシュロックを取得します。

プッシュロックは、共有アクセスまたは排他アクセス用に取得できる点で、ERESOURCE 構造体 (リソースとも呼ばれます) に似ています。プッシュロックの詳細については、 FltInitializePushLock のリファレンスエントリを参照してください。

ERESOURCE 構造体とは異なり、プッシュロックを再帰的に取得することはできません。呼び出し元が排他アクセスのプッシュロックを既に取得している場合、システムはハングします。呼び出し元が既に共有アクセスのプッシュロックを取得している場合は、再び共有アクセスを受信できます。ただし、 FltAcquirePushLockShared の各呼び出しは、 FltReleasePushLock の後続の呼び出しと一致する必要があります。

呼び出し元に、指定されたプッシュロックへの共有アクセス権が付与されるタイミングは、次に依存します。

プッシュロックが現在所有されていない場合は、現在のスレッドに対してすぐに共有アクセスが許可されます。
別のスレッドによる共有アクセスに対してプッシュロックが既に取得されていて、プッシュロックへの排他アクセスを待機しているスレッドがない場合、共有アクセスはすぐに呼び出し元に付与されます。排他ウェイターがある場合、呼び出し元は待機状態になります。
別のスレッドによる排他アクセスのためにプッシュロックが既に取得されている場合、または排他アクセスを待機している別のスレッドがある場合、現在のスレッドは、プッシュロックを取得できるようになるまで待機状態になります。

FltAcquirePushLockShared は通常のカーネル APC 配信を無効にするため、FltAcquirePushLockShared を呼び出す前に KeEnterCriticalRegion または FsRtlEnterFileSystem を呼び出す必要はありません。

プッシュロックを取得した後で解放するには、 FltReleasePushLock を呼び出します。 FltAcquirePushLockShared に対するすべての呼び出しは、FltReleasePushLock の後続の呼び出しと一致する必要があります。

排他アクセスのプッシュロックを取得するには、 FltAcquirePushLockExclusive を呼び出します。

プッシュロックを初期化するには、 FltInitializePushLock を呼び出します。

プッシュロックを削除するには、 FltDeletePushLock を呼び出します。