FxWatchdog Struct Reference

#include <fxwatchdog.hpp>

Collaboration diagram for FxWatchdog:

Public Member Functions
	FxWatchdog (__in FxPkgPnp *PkgPnp)
VOID	StartTimer (__in ULONG State)
VOID	CancelTimer (__in ULONG State)

Public Attributes
MxTimer	m_Timer
FxPkgPnp *	m_PkgPnp
MxThread	m_CallingThread

Static Public Attributes
static MdDeferredRoutineType	_WatchdogDpc

Detailed Description

Definition at line 29 of file fxwatchdog.hpp.

Constructor & Destructor Documentation

FxWatchdog()

FxWatchdog::FxWatchdog ( __in FxPkgPnp *  PkgPnp )

inline

Definition at line 30 of file fxwatchdog.hpp.

    {
        m_PkgPnp = PkgPnp;
    }

Member Function Documentation

CancelTimer()

VOID FxWatchdog::CancelTimer ( __in ULONG  State )

inline

Definition at line 91 of file fxwatchdog.hpp.

    {
        if (State & WdfDevStateNP) {
            //
            // The state was successfully handled without the timer expiring.
            // We don't care about the return code in this case.
            //
            (void) m_Timer.Stop();
        }
    }

Referenced by FxPkgPnp::PowerEnterNewState(), and FxPkgPnp::PowerPolicyEnterNewState().

StartTimer()

VOID FxWatchdog::StartTimer ( __in ULONG  State )

inline

Definition at line 38 of file fxwatchdog.hpp.

    {
        LARGE_INTEGER time;
        NTSTATUS status;
 
        if (State & WdfDevStateNP) {
            //
            // This is a non-pageable state.  So we set the timer watchdog.
            // If it fires, it means that the driver stalled, probably due
            // to a page fault, which means that the whole machine is wedged.
            // We will then attempt to put the failure in the trace log
            // and bring the machine down, hopefully getting the reason we
            // stopped responding into the crashdump.  (This will probably only work
            // if the machine is hibernating.)
            //
            // If the state function returns, then we'll cancel the timer
            // and no love will be lost.
            //
            status = m_Timer.Initialize(this, _WatchdogDpc, 0);
 
            //
            // This code is not used in UM. Hence we can assert and assume that
            // timer start will always be successful.
            //
            WDF_VERIFY_KM_ONLY_CODE();
 
            FX_ASSERT_AND_ASSUME_FOR_PREFAST(NT_SUCCESS(status));
 
            m_CallingThread = Mx::MxGetCurrentThread();
 
            if (m_PkgPnp->m_SharedPower.m_ExtendWatchDogTimer) {
                //
                // 24 hours:
                //  60 = to minutes
                //  60 = to hours
                //  24 = number of hours
                //
                time.QuadPart = WDF_REL_TIMEOUT_IN_SEC(60 * 60 * 24);
            }
            else {
                //
                // 10 minutes from now (same as the Vista timeout)
                //
                time.QuadPart = WDF_REL_TIMEOUT_IN_SEC(60 * 10);
            }
 
            m_Timer.Start(time);
        }
    }

Referenced by FxPkgPnp::PowerEnterNewState(), and FxPkgPnp::PowerPolicyEnterNewState().

Member Data Documentation

_WatchdogDpc

MdDeferredRoutineType FxWatchdog::_WatchdogDpc

static

Definition at line 106 of file fxwatchdog.hpp.

Referenced by StartTimer().

m_CallingThread

MxThread FxWatchdog::m_CallingThread

Definition at line 112 of file fxwatchdog.hpp.

Referenced by __drv_maxIRQL(), and StartTimer().

m_PkgPnp

FxPkgPnp* FxWatchdog::m_PkgPnp

Definition at line 110 of file fxwatchdog.hpp.

Referenced by __drv_maxIRQL(), FxWatchdog(), and StartTimer().

m_Timer

MxTimer FxWatchdog::m_Timer

Definition at line 108 of file fxwatchdog.hpp.

Referenced by CancelTimer(), and StartTimer().

---

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

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