ExAcquirePushLockExclusive マクロ (wdm.h)

[アーティクル]
02/27/2024

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

構文

void ExAcquirePushLockExclusive(
   Lock
);

パラメーター

Lock

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

戻り値

なし

解説

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

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

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

このルーチンを呼び出す前に、ドライバー は KeEnterCriticalRegion を呼び出すことによって、通常のカーネル APC 配信を無効にする必要があります。 KeLeaveCriticalRegion を呼び出して、プッシュロックが解除された後に配信を再び有効にできます。詳細については、「 APC の無効化」を参照してください。

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

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