FltAcquirePushLockExclusive 関数 (fltkernel.h)

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

FltAcquirePushLockExclusive マクロは、呼び出し元スレッドによる排他アクセスのために、指定されたプッシュロックを取得します。

構文

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

パラメーター

[in, out] PushLock

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

戻り値

[なし] :

解説

FltAcquirePushLockExclusive は、呼び出し元スレッドによる排他アクセスのために、指定されたプッシュロックを取得します。

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

ERESOURCE 構造体とは異なり、プッシュロックを再帰的に取得することはできません。呼び出し元が排他アクセスまたは共有アクセスのプッシュロックを既に取得している場合、スレッドはハングします。

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

プッシュロックが現在所有されていない場合は、現在のスレッドへの排他アクセスが直ちに付与されます。
別のスレッドによる排他アクセスまたは共有アクセスのためにプッシュロックが既に取得されている場合、プッシュロックを取得できるようになるまで、現在のスレッドは待機状態になります。

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

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

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

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

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