interlocked.c File Reference

#include <ntoskrnl.h>
#include <debug.h>

Include dependency graph for interlocked.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
FORCEINLINE BOOLEAN	_ExiDisableInterruptsAndAcquireSpinlock (IN OUT PKSPIN_LOCK Lock)
FORCEINLINE VOID	_ExiReleaseSpinLockAndRestoreInterrupts (IN OUT PKSPIN_LOCK Lock, BOOLEAN Enable)
LARGE_INTEGER NTAPI	ExInterlockedAddLargeInteger (IN OUT PLARGE_INTEGER Addend, IN LARGE_INTEGER Increment, IN OUT PKSPIN_LOCK Lock)
ULONG NTAPI	ExInterlockedAddUlong (IN OUT PULONG Addend, IN ULONG Increment, IN OUT PKSPIN_LOCK Lock)
PLIST_ENTRY NTAPI	ExInterlockedInsertHeadList (IN OUT PLIST_ENTRY ListHead, IN OUT PLIST_ENTRY ListEntry, IN OUT PKSPIN_LOCK Lock)
PLIST_ENTRY NTAPI	ExInterlockedInsertTailList (IN OUT PLIST_ENTRY ListHead, IN OUT PLIST_ENTRY ListEntry, IN OUT PKSPIN_LOCK Lock)
PLIST_ENTRY NTAPI	ExInterlockedRemoveHeadList (IN OUT PLIST_ENTRY ListHead, IN OUT PKSPIN_LOCK Lock)
PSINGLE_LIST_ENTRY NTAPI	ExInterlockedPopEntryList (IN OUT PSINGLE_LIST_ENTRY ListHead, IN OUT PKSPIN_LOCK Lock)
PSINGLE_LIST_ENTRY NTAPI	ExInterlockedPushEntryList (IN OUT PSINGLE_LIST_ENTRY ListHead, IN OUT PSINGLE_LIST_ENTRY ListEntry, IN OUT PKSPIN_LOCK Lock)
INTERLOCKED_RESULT NTAPI	ExInterlockedIncrementLong (IN PLONG Addend, IN PKSPIN_LOCK Lock)
INTERLOCKED_RESULT NTAPI	ExInterlockedDecrementLong (IN PLONG Addend, IN PKSPIN_LOCK Lock)
ULONG NTAPI	ExInterlockedExchangeUlong (IN PULONG Target, IN ULONG Value, IN PKSPIN_LOCK Lock)

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 13 of file interlocked.c.

Function Documentation

_ExiDisableInterruptsAndAcquireSpinlock()

FORCEINLINE BOOLEAN _ExiDisableInterruptsAndAcquireSpinlock

(

IN OUT PKSPIN_LOCK

Lock

)

Definition at line 32 of file interlocked.c.

{
    BOOLEAN Enabled;
 
    /* Disable interrupts */
    Enabled = KeDisableInterrupts();
 
    /* Acquire the spinlock (inline) */
    KxAcquireSpinLock(Lock);
 
    return Enabled;
}

Referenced by ExInterlockedAddLargeInteger(), ExInterlockedAddUlong(), ExInterlockedInsertHeadList(), ExInterlockedInsertTailList(), ExInterlockedPopEntryList(), ExInterlockedPushEntryList(), and ExInterlockedRemoveHeadList().

_ExiReleaseSpinLockAndRestoreInterrupts()

FORCEINLINE VOID _ExiReleaseSpinLockAndRestoreInterrupts	(	IN OUT PKSPIN_LOCK	Lock,
		BOOLEAN	Enable
	)

Definition at line 48 of file interlocked.c.

{
    /* Release the spinlock */
    KxReleaseSpinLock(Lock);
 
    /* Restore interrupts */
    KeRestoreInterrupts(Enable);
}

Referenced by ExInterlockedAddLargeInteger(), ExInterlockedAddUlong(), ExInterlockedInsertHeadList(), ExInterlockedInsertTailList(), ExInterlockedPopEntryList(), ExInterlockedPushEntryList(), and ExInterlockedRemoveHeadList().

ExInterlockedAddLargeInteger()

LARGE_INTEGER NTAPI ExInterlockedAddLargeInteger	(	IN OUT PLARGE_INTEGER	Addend,
		IN LARGE_INTEGER	Increment,
		IN OUT PKSPIN_LOCK	Lock
	)

Definition at line 62 of file interlocked.c.

{
    LARGE_INTEGER OldValue;
    BOOLEAN Enable;
 
    /* Disable interrupts and acquire the spinlock */
    Enable = _ExiDisableInterruptsAndAcquireSpinlock(Lock);
 
    /* Save the old value */
    OldValue.QuadPart = Addend->QuadPart;
 
    /* Do the operation */
    Addend->QuadPart += Increment.QuadPart;
 
    /* Release the spinlock and restore interrupts */
    _ExiReleaseSpinLockAndRestoreInterrupts(Lock, Enable);
 
    /* Return the old value */
    return OldValue;
}

Referenced by NdisInterlockedAddLargeInteger(), and TestInterlockedFunctional().

ExInterlockedAddUlong()

ULONG NTAPI ExInterlockedAddUlong	(	IN OUT PULONG	Addend,
		IN ULONG	Increment,
		IN OUT PKSPIN_LOCK	Lock
	)

Definition at line 88 of file interlocked.c.

{
    BOOLEAN Enable;
    ULONG OldValue;
 
    /* Disable interrupts and acquire the spinlock */
    Enable = _ExiDisableInterruptsAndAcquireSpinlock(Lock);
 
    /* Save the old value */
    OldValue = *Addend;
 
    /* Do the operation */
    *Addend += Increment;
 
    /* Release the spinlock and restore interrupts */
    _ExiReleaseSpinLockAndRestoreInterrupts(Lock, Enable);
 
    /* Return the old value */
    return OldValue;
}

Referenced by _Requires_lock_held_(), FatMultiAsyncCompletionRoutine(), FatSingleAsyncCompletionRoutine(), NdisInterlockedAddUlong(), RxCommonWrite(), RxLowIoWriteShellCompletion(), and TestInterlockedFunctional().

ExInterlockedDecrementLong()

INTERLOCKED_RESULT NTAPI ExInterlockedDecrementLong	(	IN PLONG	Addend,
		IN PKSPIN_LOCK	Lock
	)

Definition at line 267 of file interlocked.c.

{
    LONG Result;
 
    Result = _InterlockedDecrement(Addend);
    return (Result < 0) ? ResultNegative :
           (Result > 0) ? ResultPositive :
           ResultZero;
}

ExInterlockedExchangeUlong()

ULONG NTAPI ExInterlockedExchangeUlong	(	IN PULONG	Target,
		IN ULONG	Value,
		IN PKSPIN_LOCK	Lock
	)

Definition at line 281 of file interlocked.c.

{
    return (ULONG)_InterlockedExchange((PLONG)Target, (LONG)Value);
}

ExInterlockedIncrementLong()

INTERLOCKED_RESULT NTAPI ExInterlockedIncrementLong	(	IN PLONG	Addend,
		IN PKSPIN_LOCK	Lock
	)

Definition at line 253 of file interlocked.c.

{
    LONG Result;
 
    Result = _InterlockedIncrement(Addend);
    return (Result < 0) ? ResultNegative :
           (Result > 0) ? ResultPositive :
           ResultZero;
}

ExInterlockedInsertHeadList()

PLIST_ENTRY NTAPI ExInterlockedInsertHeadList	(	IN OUT PLIST_ENTRY	ListHead,
		IN OUT PLIST_ENTRY	ListEntry,
		IN OUT PKSPIN_LOCK	Lock
	)

Definition at line 114 of file interlocked.c.

{
    BOOLEAN Enable;
    PLIST_ENTRY FirstEntry;
 
    /* Disable interrupts and acquire the spinlock */
    Enable = _ExiDisableInterruptsAndAcquireSpinlock(Lock);
 
    /* Save the first entry */
    FirstEntry = ListHead->Flink;
 
    /* Insert the new entry */
    InsertHeadList(ListHead, ListEntry);
 
    /* Release the spinlock and restore interrupts */
    _ExiReleaseSpinLockAndRestoreInterrupts(Lock, Enable);
 
    /* Return the old first entry or NULL for empty list */
    return (FirstEntry == ListHead) ? NULL : FirstEntry;
}

Referenced by CcCanIWrite(), CcDeferWrite(), CcPostDeferredWrites(), IopLogWorker(), IoRegisterLastChanceShutdownNotification(), IoRegisterShutdownNotification(), LwipThreadMain(), NdisInterlockedInsertHeadList(), ReadIrpCancel(), START_TEST(), and USBPORT_IsrDpcHandler().

ExInterlockedInsertTailList()

PLIST_ENTRY NTAPI ExInterlockedInsertTailList	(	IN OUT PLIST_ENTRY	ListHead,
		IN OUT PLIST_ENTRY	ListEntry,
		IN OUT PKSPIN_LOCK	Lock
	)

Definition at line 140 of file interlocked.c.

{
    BOOLEAN Enable;
    PLIST_ENTRY LastEntry;
 
    /* Disable interrupts and acquire the spinlock */
    Enable = _ExiDisableInterruptsAndAcquireSpinlock(Lock);
 
    /* Save the last entry */
    LastEntry = ListHead->Blink;
 
    /* Insert the new entry */
    InsertTailList(ListHead, ListEntry);
 
    /* Release the spinlock and restore interrupts */
    _ExiReleaseSpinLockAndRestoreInterrupts(Lock, Enable);
 
    /* Return the old last entry or NULL for empty list */
    return (LastEntry == ListHead) ? NULL : LastEntry;
}

Referenced by _Dispatch_type_(), AfdEventReceiveDatagramHandler(), BindAdapterByName(), CcCanIWrite(), CcDeferWrite(), ChewCreate(), ConnectPortDriver(), ExInitializeNPagedLookasideList(), ExInitializePagedLookasideList(), FdoEnumerateDevices(), FdoStartDevice(), FileOpenAddress(), InsertAudioDevice(), IntVideoPortFindAdapter(), IoInitializeTimer(), IoRegisterBootDriverReinitialization(), IoRegisterDriverReinitialization(), KsAddEvent(), KsDefaultAddEventHandler(), LanCreateProtocol(), LanReadData(), LANRegisterAdapter(), MiInitializeWorkingSetList(), NdisCompleteBindAdapter(), NdisInitializeWrapper(), NdisInterlockedInsertTailList(), NdisIPnPStartDevice(), NdisOpenAdapter(), NdisReadConfiguration(), NdisReadNetworkAddress(), NdisRegisterProtocol(), NduReceive(), START_TEST(), sys_mbox_post(), TCPAllocateConnectionEndpoint(), TcpipInterlockedInsertTailList(), USBH_QueueWorkItem(), USBPORT_AddUSB1Fdo(), USBPORT_AddUSB2Fdo(), USBPORT_DeleteEndpoint(), USBPORT_EndpointWorker(), USBPORT_OpenPipe(), USBPORT_QueueDoneTransfer(), USBPORT_RegisterUSBPortDriver(), USBPORT_RootHubEndpointWorker(), USBPORT_SetEndpointState(), VfdDeviceControl(), VfdReadWrite(), and WdmAudOpenSysaudio().

ExInterlockedPopEntryList()

PSINGLE_LIST_ENTRY NTAPI ExInterlockedPopEntryList	(	IN OUT PSINGLE_LIST_ENTRY	ListHead,
		IN OUT PKSPIN_LOCK	Lock
	)

Definition at line 201 of file interlocked.c.

{
    BOOLEAN Enable;
    PSINGLE_LIST_ENTRY ListEntry;
 
    /* Disable interrupts and acquire the spinlock */
    Enable = _ExiDisableInterruptsAndAcquireSpinlock(Lock);
 
    /* Pop the first entry from the list */
    ListEntry = PopEntryList(ListHead);
#if DBG
    if (ListEntry)
        ListEntry->Next = (PSINGLE_LIST_ENTRY)(ULONG_PTR)0xBADDD0FFBADDD0FFULL;
#endif
 
    /* Release the spinlock and restore interrupts */
    _ExiReleaseSpinLockAndRestoreInterrupts(Lock, Enable);
 
    /* Return the entry */
    return ListEntry;
}

Referenced by DiskReregWorker().

ExInterlockedPushEntryList()

PSINGLE_LIST_ENTRY NTAPI ExInterlockedPushEntryList	(	IN OUT PSINGLE_LIST_ENTRY	ListHead,
		IN OUT PSINGLE_LIST_ENTRY	ListEntry,
		IN OUT PKSPIN_LOCK	Lock
	)

Definition at line 227 of file interlocked.c.

{
    BOOLEAN Enable;
    PSINGLE_LIST_ENTRY OldListEntry;
 
    /* Disable interrupts and acquire the spinlock */
    Enable = _ExiDisableInterruptsAndAcquireSpinlock(Lock);
 
    /* Save the old top entry */
    OldListEntry = ListHead->Next;
 
    /* Push a new entry on the list */
    PushEntryList(ListHead, ListEntry);
 
    /* Release the spinlock and restore interrupts */
    _ExiReleaseSpinLockAndRestoreInterrupts(Lock, Enable);
 
    /* Return the entry */
    return OldListEntry;
}

Referenced by DiskPostReregisterRequest().

ExInterlockedRemoveHeadList()

PLIST_ENTRY NTAPI ExInterlockedRemoveHeadList	(	IN OUT PLIST_ENTRY	ListHead,
		IN OUT PKSPIN_LOCK	Lock
	)

Definition at line 166 of file interlocked.c.

{
    BOOLEAN Enable;
    PLIST_ENTRY ListEntry;
 
    /* Disable interrupts and acquire the spinlock */
    Enable = _ExiDisableInterruptsAndAcquireSpinlock(Lock);
 
    /* Check if the list is empty */
    if (IsListEmpty(ListHead))
    {
        /* Return NULL */
        ListEntry = NULL;
    }
    else
    {
        /* Remove the first entry from the list head */
        ListEntry = RemoveHeadList(ListHead);
#if DBG
        ListEntry->Flink = (PLIST_ENTRY)(ULONG_PTR)0xBADDD0FFBADDD0FFULL;
        ListEntry->Blink = (PLIST_ENTRY)(ULONG_PTR)0xBADDD0FFBADDD0FFULL;
#endif
    }
 
    /* Release the spinlock and restore interrupts */
    _ExiReleaseSpinLockAndRestoreInterrupts(Lock, Enable);
 
    /* Return the entry */
    return ListEntry;
}

Referenced by CcPostDeferredWrites(), IopReinitializeBootDrivers(), IopReinitializeDrivers(), IoShutdownSystem(), LoadSymbolsRoutine(), NBSendPackets(), NdisCloseConfiguration(), NdisInterlockedRemoveHeadList(), START_TEST(), sys_shutdown(), USBH_FlushPortPwrList(), USBPORT_IsrDpcHandler(), and VfdDeviceThread().