FxCallbackMutexLock Class Reference

#include <fxcallbackmutexlock.hpp>

Inheritance diagram for FxCallbackMutexLock:

Collaboration diagram for FxCallbackMutexLock:

Public Member Functions
	FxCallbackMutexLock (PFX_DRIVER_GLOBALS FxDriverGlobals)
virtual	~FxCallbackMutexLock ()
virtual void	Initialize (FxObject *ParentObject)
virtual void	Lock (__out PKIRQL PreviousIrql)
virtual void	Unlock (__in KIRQL PreviousIrql)
virtual _Must_inspect_result_ BOOLEAN	IsOwner (VOID)
Public Member Functions inherited from FxCallbackLock
	FxCallbackLock (PFX_DRIVER_GLOBALS FxDriverGlobals)
virtual	~FxCallbackLock ()
virtual void	Initialize (FxObject *ParentObject)=0
virtual void	Lock (__out PKIRQL PreviousIrql)=0
virtual void	Unlock (__in KIRQL PreviousIrql)=0
virtual _Must_inspect_result_ BOOLEAN	IsOwner (VOID)=0
VOID	CheckOwnership (VOID)
Public Member Functions inherited from FxGlobalsStump
	FxGlobalsStump (__in PFX_DRIVER_GLOBALS FxDriverGlobals)
PFX_DRIVER_GLOBALS	GetDriverGlobals (VOID)
Public Member Functions inherited from FxStump
PVOID	operator new (__in size_t Size, __in PFX_DRIVER_GLOBALS FxDriverGlobals)
PVOID	operator new (__in size_t Size, __in PFX_DRIVER_GLOBALS FxDriverGlobals, __in POOL_TYPE PoolType)
VOID	operator delete (__in PVOID pointer)
PVOID	operator new[] (__in size_t Size, __in PFX_DRIVER_GLOBALS FxDriverGlobals)
VOID	operator delete[] (__in PVOID pointer)

Private Attributes
MxPagedLock	m_Lock

Additional Inherited Members
Public Attributes inherited from FxCallbackLock
KIRQL	m_PreviousIrql
Protected Member Functions inherited from FxStump
	FxStump (VOID)
Protected Attributes inherited from FxCallbackLock
MxThread	m_OwnerThread
ULONG	m_RecursionCount
FxVerifierLock *	m_Verifier

Detailed Description

Definition at line 34 of file fxcallbackmutexlock.hpp.

Constructor & Destructor Documentation

FxCallbackMutexLock()

FxCallbackMutexLock::FxCallbackMutexLock ( PFX_DRIVER_GLOBALS  FxDriverGlobals )

inline

Definition at line 48 of file fxcallbackmutexlock.hpp.

          :
        FxCallbackLock(FxDriverGlobals)
    {
        m_Lock.Initialize();
    }

~FxCallbackMutexLock()

virtual FxCallbackMutexLock::~FxCallbackMutexLock ( )

inlinevirtual

Definition at line 57 of file fxcallbackmutexlock.hpp.

    {
        if (m_Verifier) {
            delete m_Verifier;
        }
    }

Member Function Documentation

Initialize()

virtual void FxCallbackMutexLock::Initialize ( FxObject *  ParentObject )

inlinevirtual

Implements FxCallbackLock.

Definition at line 66 of file fxcallbackmutexlock.hpp.

    {
        PFX_DRIVER_GLOBALS fxDriverGlobals;
 
        m_Verifier = NULL;
        fxDriverGlobals = GetDriverGlobals();
 
        if (fxDriverGlobals->FxVerifierLock) {
 
            //
            // VerifierLock CreateAndInitialize failure is not fatal,
            // we just won't track anything
            //
            (void) FxVerifierLock::CreateAndInitialize(&m_Verifier,
                                                       fxDriverGlobals,
                                                       ParentObject,
                                                       TRUE);
        }
    }

Referenced by FxDriver::ConfigureConstraints(), and FxIoQueue::ConfigureConstraints().

IsOwner()

virtual _Must_inspect_result_ BOOLEAN FxCallbackMutexLock::IsOwner ( VOID  )

inlinevirtual

Implements FxCallbackLock.

Definition at line 158 of file fxcallbackmutexlock.hpp.

    {
        MxThread cur = Mx::MxGetCurrentThread();
 
        if (m_OwnerThread == cur) {
            return TRUE;
        }
        else {
            return FALSE;
        }
    }

Lock()

virtual void FxCallbackMutexLock::Lock ( __out PKIRQL  PreviousIrql )

inlinevirtual

Implements FxCallbackLock.

Definition at line 90 of file fxcallbackmutexlock.hpp.

    {
        MxThread cur = Mx::MxGetCurrentThread();
 
        if (m_OwnerThread == cur) {
            PFX_DRIVER_GLOBALS fxDriverGlobals;
 
            fxDriverGlobals = GetDriverGlobals();
            m_RecursionCount++;
 
            //
            // For now we have decided not to allow this.
            //
 
 
 
 
 
 
 
            //
            DoTraceLevelMessage(fxDriverGlobals, TRACE_LEVEL_FATAL, TRACINGDEVICE,
                                "Recursive acquire of callback lock 0x%p", this);
 
            FxVerifierBugCheck(fxDriverGlobals,
                               WDF_RECURSIVE_LOCK,
                               (ULONG_PTR)this);
        }
        else {
            if (m_Verifier != NULL) {
                m_Verifier->Lock(PreviousIrql, FALSE);
            }
            else {
                Mx::MxEnterCriticalRegion();
                m_Lock.AcquireUnsafe();
            }
            m_OwnerThread = cur;
        }
    }

Unlock()

virtual void FxCallbackMutexLock::Unlock ( __in KIRQL  PreviousIrql )

inlinevirtual

Implements FxCallbackLock.

Definition at line 134 of file fxcallbackmutexlock.hpp.

    {
        CheckOwnership();
 
        if (m_RecursionCount > 0) {
            m_RecursionCount--;
        }
        else {
            m_OwnerThread = NULL;
            if (m_Verifier) {
                m_Verifier->Unlock(PreviousIrql, FALSE);
            }
            else {
                m_Lock.ReleaseUnsafe();
                Mx::MxLeaveCriticalRegion();
            }
        }
    }

Member Data Documentation

m_Lock

MxPagedLock FxCallbackMutexLock::m_Lock

private

Definition at line 44 of file fxcallbackmutexlock.hpp.

Referenced by FxCallbackMutexLock(), Lock(), and Unlock().

---

The documentation for this class was generated from the following file:

• sdk/lib/drivers/wdf/shared/inc/private/common/fxcallbackmutexlock.hpp