Skip to content

Latest commit

 

History

History
69 lines (55 loc) · 2.81 KB

nf-wdm-extryconvertsharedspinlockexclusive.md

File metadata and controls

69 lines (55 loc) · 2.81 KB
UID title description tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:wdm.ExTryConvertSharedSpinLockExclusive
ExTryConvertSharedSpinLockExclusive function (wdm.h)
The ExTryConvertSharedSpinLockExclusive routine attempts to convert the access state of a spin lock from acquired for shared access to exclusive access.
kernel
10/18/2022
ExTryConvertSharedSpinLockExclusive function
ExTryConvertSharedSpinLockExclusive, ExTryConvertSharedSpinLockExclusive routine [Kernel-Mode Driver Architecture], kernel.extryconvertsharedspinlockexclusive_, wdm/ExTryConvertSharedSpinLockExclusive
wdm.h
Universal
Ntoskrnl.lib
DISPATCH_LEVEL
Windows
ExTryConvertSharedSpinLockExclusive
wdm/ExTryConvertSharedSpinLockExclusive
APIRef
kbSyntax
LibDef
ntoskrnl.lib
ntoskrnl.dll
ExTryConvertSharedSpinLockExclusive

-description

The ExTryConvertSharedSpinLockExclusive routine attempts to convert the access state of a spin lock from acquired for shared access to exclusive access.

-parameters

-param SpinLock [in, out]

A pointer to the spin lock whose access state is to be converted to exclusive access. The caller must already own this spin lock for shared access.

-returns

ExTryConvertSharedSpinLockExclusive returns TRUE if the conversion succeeds; otherwise, it returns FALSE.

-remarks

If the caller acquired the shared spin lock by calling the ExAcquireSpinLockSharedAtDpcLevel routine, the caller should release the converted spin lock by calling the ExReleaseSpinLockExclusiveFromDpcLevel routine. If the caller acquired the shared spin lock by calling the ExAcquireSpinLockShared routine, the caller should release the converted spin lock by calling the ExReleaseSpinLockExclusive routine, and the OldIrql value supplied as an input parameter to this routine should be the KIRQL value returned by ExAcquireSpinLockShared.

-see-also

ExAcquireSpinLockShared

ExAcquireSpinLockSharedAtDpcLevel

ExReleaseSpinLockExclusive

ExReleaseSpinLockExclusiveFromDpcLevel