KeAcquireInStackQueuedSpinLock 関数 (wdm.h)

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

KeAcquireInStackQueuedSpinLock ルーチンは、キューに入ったスピンロックを取得します。

構文

void KeAcquireInStackQueuedSpinLock(
  PKSPIN_LOCK         SpinLock,
  PKLOCK_QUEUE_HANDLE LockHandle
);

パラメーター

SpinLock

[入力、出力]取得するスピンロックを指定します。このパラメーターは 、KeInitializeSpinLock で初期化されている必要があります。

LockHandle

[out]呼び出し元が指定した KLOCK_QUEUE_HANDLE 変数へのポインター。この変数は、ルーチンがスピンロックキューハンドルを返すために使用できます。呼び出し元は、ロックを解除するときに、この値を KeReleaseInStackQueuedSpinLock に渡します。ドライバーは通常、ロックを取得するたびにスタックに構造体を割り当てる必要があります。ドライバーは、複数の呼び出し元サイトから同じKLOCK_QUEUE_HANDLEを使用しないでください。

戻り値

なし

解説

KeAcquireInStackQueuedSpinLock は、 キューに入ったスピンロックとしてスピンロックを取得します。詳細については、「キューに入ったスピンロック」を参照してください。呼び出し元は、 KeReleaseInStackQueuedSpinLock ルーチンを呼び出してスピンロックを解放します。

通常のスピンロックと同様に、キューに入っているスピンロックは、非常に特殊な状況でのみ使用する必要があります。スピンロックを使用するタイミングの詳細については、「 KeAcquireSpinLock」を参照してください。

このルーチンは、スピンロックを取得するときに IRQL レベルをDISPATCH_LEVELに上げます。呼び出し元がDISPATCH_LEVELで既に実行されていることが保証されている場合は、 KeAcquireInStackQueuedSpinLockAtDpcLevel を呼び出す方が効率的です。

スピンロックを解放する KeReleaseInStackQueuedSpinLock の呼び出しは、IRQL = DISPATCH_LEVELで行う必要があります。この呼び出しにより、オペレーティングシステムが KeAcquireInStackQueuedSpinLock 呼び出しの開始時に保存した元の IRQL が復元されます。

ドライバーは、同じスピン ロックで KeAcquireSpinLock と KeAcquireInStackQueuedSpinLock の呼び出しを組み合わせてはいけません。スピンロックは常に、キューに登録されたスピンロックとして、または通常のスピンロックとして取得または解放する必要があります。

要件

要件	値
Header	wdm.h (Wdm.h を含む)
IRQL	IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), MarkingQueuedIrps(wdm), QueuedSpinLock(storport), QueuedSpinLock(wdm), QueuedSpinLockRelease(storport), QueuedSpinLockRelease(wdm)