WdfSpinLockAcquire function (wdfsync.h)

The WdfSpinLockAcquire method acquires a specified spin lock.

Syntax

void WdfSpinLockAcquire(
  WDFSPINLOCK SpinLock
);

Parameters

SpinLock

A handle to a framework spin-lock object, obtained by a previous call to WdfSpinLockCreate.

Return value

None

Remarks

The WdfSpinLockAcquire method returns after the specified spin lock has been acquired. For KMDF, the method returns at IRQL = DISPATCH_LEVEL. For UMDF, the method returns at passive.

Your driver cannot call WdfSpinLockAcquire to acquire a spin lock that the driver has specified in a WDF_INTERRUPT_CONFIG structure.

For more information about spin locks, see Using Framework Locks.

Requirements

Requirement Value
Minimum KMDF version 1.0
Minimum UMDF version 2.0
Header wdfsync.h (include Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI compliance rules DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), ReqSendWhileSpinlock(kmdf), WdfSpinlock(kmdf), WdfSpinlockRelease(kmdf)

See also

WdfSpinLockCreate

WdfSpinLockRelease

WdfSpinlock rule (KMDF)

WdfSpinLockRelease rule (KMDF)