KeAcquireSpinLockRaiseToDpc

The KeAcquireSpinLockRaiseToDpc routine is a faster version of the KeAcquireSpinLock routine.

NTKERNELAPI
KIRQL
  KeAcquireSpinLockRaiseToDpc (
    IN PKSPIN_LOCK  SpinLock 
    );

Parameters

SpinLock

Specifies the spin lock to acquire. The spin lock must already have been initialized by KeInitializeSpinLock.

Return Value

KeAcquireSpinLockRaiseToDpc returns the current IRQL at the time the routine is called. This value is passed to KeReleaseSpinLock when the spin lock is released.

Headers

Declared in wdm.h and ntddk.h. Include wdm.h or ntddk.h.

Comments

Drivers for Windows XP and later should use the more efficient and reliable queued spin locks, which are acquired by the KeAcquireInStackQueuedSpinLock routine.

The effect of this routine is identical to that of KeAcquireSpinLock. In particular, the acquired spin lock is released by KeReleaseSpinLock. For more information, see the reference page for KeAcquireSpinLock.

Drivers can try to acquire the spin lock without blocking by using KeTryToAcquireSpinLockAtDpcLevel.

Callers of this routine must be running at IRQL <= DISPATCH_LEVEL.

See Also

KeAcquireInStackQueuedSpinLock, KeAcquireSpinLock, KeInitializeSpinLock